Question 1

Copilot SDK가 127.0.0.1 또는 localhost 요청을 HTTP 프록시를 통해 라우팅하지 않도록 하려면 어떻게 해야 하나요?

Accepted Answer

로컬 BYOK 엔드포인트가 프록시를 우회하도록 `NO_PROXY`에 루프백 주소를 설정합니다:

```bash
export NO_PROXY="127.0.0.1,::1,localhost"
export no_proxy="127.0.0.1,::1,localhost"
```

Windows (PowerShell)의 경우:

```powershell
$env:NO_PROXY="127.0.0.1,::1,localhost"
$env:no_proxy="127.0.0.1,::1,localhost"
```

변수를 설정한 후 VS Code를 다시 시작하세요. Agent Host PR에는 `HTTP_PROXY`/`HTTPS_PROXY`를 주입할 때 루프백 호스트를 `NO_PROXY`에 자동으로 추가하는 영구 수정이 포함되어 있습니다. 해당 변경 사항이 포함된 VS Code/Copilot SDK 릴리스로 업데이트하세요.

Question 2

Copilot SDK Rust 세션에서 스폰된 서브 에이전트가 실패하거나 유휴 상태가 될 때 `send_and_wait`가 잘못된 결과로 조기에 resolve되는 이유는 무엇인가요?

Accepted Answer

이것은 CLI 런타임 `1.0.84-5`를 사용하는 `github/copilot-sdk` Rust `v1.0.14`의 버그입니다. CLI는 하위 에이전트 이벤트를 자식의 `agent_id`와 함께 부모 세션 스트림으로 다시 내보내지만, `rust/src/session.rs`의 `handle_notification`은 `agent_id`를 확인하지 않고 모든 `session.idle`, `session.error`, `assistant.message`가 부모의 `send_and_wait` waiter를 완료하도록 허용합니다.

PR `fix(rust): only root-agent events complete send_and_wait`가 포함된 릴리스로 업그레이드하여 이 문제를 수정하세요. 임시 로컬 패치로는 waiter 완료 및 마지막 메시지 업데이트를 루트 에이전트 이벤트로만 제한하세요:

```rust
// In the send_and_wait waiter arm of handle_notification
let is_root_event = notification
    .agent_id
    .as_ref()
    .is_none_or(|id| id == &root_agent_id);

if is_root_event {
    match notification.method.as_str() {
        "session.idle" | "session.error" => {
            // resolve the waiter
        }
        "assistant.message" => {
            // update the waiter's last message
        }
        _ => {}
    }
}
```

자식 태그가 지정된 이벤트는 여전히 `on_event`로 전달되어야 하며, `send_and_wait` waiter에서만 무시되어야 합니다. 진행 중인 부모 대기가 자식 `agent_id`가 포함된 `session.error`를 수신한 후에도 보류 상태를 유지하고, 루트 `session.idle` 이후에만 해결되는지 확인하는 회귀 테스트로 검증하세요.

Question 3

Copilot SDK Rust crate에서 SessionFsProvider가 바인딩되면 Client::create_session이 왜 멈추나요?

Accepted Answer

데드락은 세션 이벤트 루프가 시작되기 전에 `session.create`가 전송되기 때문에 발생합니다. 생성 과정에서 CLI는 인바운드 `sessionFs.stat`/`sessionFs.writeFile` 요청을 전송하지만, 아직 이를 디스패치하는 주체가 없어 RPC가 무기한 대기하게 됩니다. 이 문제는 PR `fix(rust): start the session event loop before the session.create RPC`에서 `session.create`를 호출하기 전에 이벤트 루프를 스폰하도록 수정되었으며, 이는 기존 `session.resume` 동작과 일치합니다. 해당 수정이 포함된 릴리스로 업그레이드하세요. `rust/v1.0.14`에서는 `rust/src/session.rs`의 `start_prepared_create`를 패치하여 `spawn_event_loop`가 `call_with_inline_callback`보다 먼저 실행되도록 하는 것이 우회 방법입니다.

Question 4

세션 등록이 교체되기 전에 clone된 sender를 통해 Rust 라우터가 요청을 큐에 넣으면 버그인가요?

Accepted Answer

코드 수정이 필요하지 않습니다. 이는 관찰 가능한 버그가 아닙니다. router task는 각 per-session channel의 유일한 producer이며, unbounded send는 블록되지 않습니다. 따라서 동시에 일어나는 re-registration 이전에 clone된 sender를 통해 전송하는 것은, 교체가 발생하기 전 lookup 시점에서 해당 send를 linearize하는 것과 동일합니다. enqueue 동안 router lock을 보유하더라도 도달 가능한 결과는 바뀌지 않습니다. Session-ID 재사용, unknown-session 드롭, wire protocol은 변경되지 않은 상태로 유지됩니다.

copilot-sdk

개요

README 미리보기

FAQ (4)

同类型项目

tensorflow

superpowers

everything-claude-code

flutter