> ## Documentation Index
> Fetch the complete documentation index at: https://docs.archetype.ing/llms.txt
> Use this file to discover all available pages before exploring further.

# SDK

> 내 코드에서 Archetype 호스트에 연결합니다.

```bash theme={null}
npm i @pairful/archetype-sdk
```

SDK는 호스트에 연결만 합니다. 호스트를 띄우지 않고, 자체 입출력이 없어서 브라우저에서도 돕니다.

## 연결, 요청, 답

```ts theme={null}
import {
  ClientConnectionService,
  ConnectorAdapter,
} from "@pairful/archetype-sdk";

const client = await ClientConnectionService.connect(
  ConnectorAdapter.webSocketConnector(url),
  { client: "my-app" },
);
const turn = await client.startTurn("main", "run the tests");
for await (const { event } of client.events(turn)) {
  if (event.type === "approval.requested")
    await client.respond(turn, event.requestId, { action: "allow" });
}
```

턴의 이벤트는 `turn.started`부터 `turn.finished`까지 차례로 옵니다. `events(turnId, after)`로 다시 연결한 뒤 이어서 받을 수 있습니다.

## 연결 방식

| 연결 | 쓰는 곳 |
| - | - |
| `ConnectorAdapter.webSocketConnector(url)` | WebSocket으로 듣는 호스트 (`archetype --serve --listen` 등) |
| `ConnectorAdapter.inProcess(server)` | 같은 프로세스 안의 호스트 |
| `ConnectorAdapter.lineConnector({ lines, write })` | 줄 단위 JSON, 예를 들어 하위 프로세스의 표준 입출력 |

## 결정 묻기

```ts theme={null}
const { answers } = await client.decide(ticket, {
  urgent: { type: "yes_no", instructions: "Does this need attention now?" },
});
if (answers.urgent.probability > 0.8) notify(ticket);
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.