dory-to-dory-mcp 0.1.4 → 0.2.0

package/README.md

@@ -2,14 +2,26 @@
 
 로컬 또는 외부에서 직접 접근할 수 없는 Agent를 dory-to-dory Core에 연결하는 독립 MCP 서버입니다. MCP 호스트가 이 프로세스를 자식 프로세스로 실행하고 JSON-RPC를 `stdio`로 주고받습니다. Agent가 inbound 서버를 열 필요는 없습니다.
 
-## MVP 범위
+## v2 범위
 
 - Core 연결 및 자연어 정책 조회
-- 사용자 검색, 친구 및 초대 관리
-- coordination 생성·조회·취소
-- lease/fencing token이 있는 pending item claim, 구조화된 사용자 확인, 처리 결과 제출
+- 사용자 검색과 수락된 친구 조회·검색. 친구 추가·삭제는 Dashboard에서만 지원
+- 1:N coordination 생성·조회·취소와 host/client 역할별 카드
+- 생성 전 Skill 검색을 최소 1회 시도하고, 적합한 Skill 또는 goal을 바탕으로 plan 생성·결정적 skill code 실행
+- lease/fencing token이 있는 work claim, 사용자 확인, host 갱신과 client 응답 제출
+- 참여자별 nullable session 연결과 revision 기반 명시적 이동·해제
 - Core API key 기반 인증
-- MCP Tools 19개 제공 (`d2d_get_usage_guide`, `d2d_search_friends`, `d2d_check_actionable_items`, `d2d_submit_user_response` 포함)
+- MCP Tools 21개 제공
+
+버전은 `0.2.0`이며 Core `/v2` 계약이 필요합니다. npm에서 정확한 버전을 고정해 설치하거나 검증한 tarball을 사용할 수 있습니다. 구형 `/v1` 쓰기를 새 계약으로 자동 변환하지 않으며 진행 중인 구형 작업에는 기존 MCP 버전을 사용합니다.
+
+### 카드와 세션 도구
+
+`d2d_create_coordination`은 `client_handles`, `goal`을 받습니다. `goal_type`은 제거했습니다. 매 새 coordination 생성 전에 `d2d_search_coordination_skills`를 최소 한 번 호출하도록 안내합니다. 관련 후보는 `d2d_get_coordination_skill`로 조건·계획 템플릿·정확한 버전을 확인한 뒤 plan을 작성합니다. 적합한 후보가 없으면 skill 없이 직접 계획하며, 검색 이력을 서버에서 강제 검증하지는 않습니다. `d2d_run_skill_code`는 skill에 등록된 코드와 입력 스키마를 사용합니다.
+
+`d2d_claim_next_item` 결과의 `delivery.work.claim_id`와 카드 revision을 사용합니다. claim 응답에는 skill 본문을 포함하지 않습니다. 필요한 경우 `d2d_get_coordination`으로 저장된 skill을 명시적으로 조회합니다. client는 `d2d_submit_item_result`의 `to_host`만 제출하고 다른 카드 필드는 거부됩니다. host는 `d2d_update_host_card`로 plan, slots, 상태 및 다음 요청을 결정합니다. 회의 commit은 같은 proposal에 전원 준비가 확인된 뒤 host가 결정하며 최종 실행 receipt를 확인해야 완료할 수 있습니다.
+
+생성·claim·결과·host 갱신·사용자 답변에는 현재 `session_id`를 전달할 수 있습니다. 외부 Agent는 `null` 또는 생략을 사용할 수 있으며 기존 연결은 유지됩니다. 명시적 이동·해제는 `d2d_bind_session`에 `expected_session_revision`과 문자열 또는 `null`을 전달합니다. 각 Agent는 자기 연결만 접근합니다. 사용자 답변은 `interaction_id`, `answer`, 승인 질문인 경우 명시적 `decision`으로 제출합니다.
 
 MCP Resources, Prompts, 알림 push, polling daemon, FCM, Runtime Adapter는 포함하지 않습니다. 사용자가 처리할 작업을 묻거나 이메일·Telegram 알림 후 Agent를 열면 `d2d_check_actionable_items`로 사용자 답변 대기 항목을 먼저 확인합니다. Background Watcher는 SSE wake-up을 받은 뒤 `d2d_claim_next_item`으로 pending item만 처리합니다. 최종 도구 호출 여부는 MCP 호스트의 Agent 모델이 결정합니다.
 
@@ -21,27 +33,35 @@ Agent가 dory-to-dory의 목적, Watcher 설치와 device pairing, SSE 처리,
 - dory-to-dory 계정. 권장 Watcher setup이 device-code pairing으로 Agent API key를 발급하고 안전하게 저장합니다.
 - `stdio` MCP 서버를 실행할 수 있는 Agent/MCP 호스트
 
-## 권장 사용자 설치: Watcher
+## Watcher를 통한 설치
 
-일반 사용자는 Watcher를 설치하고 대화형 setup을 실행합니다. setup이 Codex CLI, Claude Code, Gemini CLI를 탐색하고 브라우저 device pairing, credential 파일 저장, MCP 등록과 연결 검사를 안내합니다. 호환되는 정확한 MCP 버전이 Watcher 의존성으로 함께 설치되므로 MCP를 별도로 설치할 필요가 없습니다.
+Watcher를 사용하면 대화형 setup으로 설치할 수 있습니다. 아래 `dory-to-dory-watcher@0.2.0` 명령은 해당 Watcher 버전이 별도로 게시된 뒤 사용합니다. MCP만 게시해도 기존 Watcher 설치의 의존성이 자동으로 바뀌지는 않습니다. Watcher 게시 전에는 Dory 앱의 검증된 번들 또는 로컬 Watcher 빌드를 사용하고, MCP를 직접 등록하려면 아래 npx 설정을 사용합니다. setup이 Codex CLI, Claude Code, Gemini CLI를 탐색하고 브라우저 device pairing, credential 파일 저장, MCP 등록과 연결 검사를 안내합니다. 호환되는 정확한 MCP 버전이 Watcher 의존성으로 함께 설치되므로 MCP를 별도로 설치할 필요가 없습니다.
 
 ```sh
-npm install --global dory-to-dory-watcher@latest
+npm install --global dory-to-dory-watcher@0.2.0
 dory-watcher setup
 ```
 
 Watcher는 Core의 SSE wake-up을 기다렸다가 pending item이 있을 때만 기존 Agent CLI를 실행합니다. macOS와 Linux에서는 선택적으로 로그인 백그라운드 서비스를 설치할 수 있고, Windows에서는 foreground `dory-watcher run`을 사용합니다. 자동 업데이트는 아직 제공하지 않습니다.
 
+Watcher는 Agent별로 지원되는 비대화식 승인과 격리 방식을 사용합니다. Codex는 `--approve-for-me --ephemeral`로 `workspace-write` 경계 안에서 Auto Review를 사용하고, Claude Code는 `--permission-mode auto`의 classifier로 도구 요청을 검토합니다. Gemini CLI에는 reviewer형 자동 검토 모드가 없으므로 현재 macOS에서만 `--approval-mode yolo --sandbox`와 `sandbox-exec`의 `strict-open` profile을 함께 사용합니다. Linux/Windows Gemini는 로컬 MCP와 credential을 container sandbox에 안전하게 연결하는 기능이 마련될 때까지 fail-closed로 거부합니다. 전역 Agent 설정은 변경하지 않으며, built-in Adapter는 권한·sandbox·config·MCP 경계를 바꾸는 추가 인자를 거부합니다. 자동 검토가 거부한 동작은 실행되지 않습니다. Agent가 계속 실행할 수 있으면 더 안전한 대안을 찾거나 `ask_user` 또는 `error`로 전환하고, 제출 전에 중단되면 Watcher가 안전한 장애 코드만 보고하며 item은 재시도할 수 있게 유지합니다.
+
+`dory-watcher doctor`는 Core와 Agent 로그인뿐 아니라 실제 무인 실행 모드도 검사합니다. Codex와 macOS Gemini에서는 빈 임시 작업공간에서 도구를 사용하지 않는 짧은 모델 진단을 한 번 실행하므로 소량의 사용량 또는 API 요금이 발생할 수 있지만, dory-to-dory item을 claim하거나 처리하지 않습니다.
+
+## 친구 추가·삭제 및 초대 관리
+
+친구 초대 생성, 확인, 수락, 거절과 취소는 MCP 도구가 아니라 [dory-to-dory 친구 관리 화면](https://dory-to-dory.dnotitia.ai/friends)에서 사용자가 직접 처리합니다. 초대가 도착하면 Core는 사용자가 활성화한 이메일과 Telegram으로 일반 알림을 보냅니다. 반복 초대에는 발신자 제한과 수신자별 알림 cooldown이 적용되며, 알림이 억제되어도 초대는 Dashboard에 표시됩니다. 상대가 초대를 수락해 친구 관계가 된 뒤에만 Coordination을 생성할 수 있습니다.
+
 ## 고급 사용자: MCP 직접 추가
 
-패키지가 npm에 게시된 뒤 MCP 호스트 설정에 다음을 추가합니다.
+MCP 호스트 설정에 정확한 버전을 지정합니다.
 
 ```json
 {
   "mcpServers": {
     "dory-to-dory": {
       "command": "npx",
-      "args": ["-y", "dory-to-dory-mcp@0.1.4"],
+      "args": ["-y", "dory-to-dory-mcp@0.2.0"],
       "env": {
         "D2D_API_KEY": "d2d_live_replace_me"
       }
@@ -52,9 +72,9 @@ Watcher는 Core의 SSE wake-up을 기다렸다가 pending item이 있을 때만
 
 호스트마다 설정 파일 위치와 최상위 키 이름은 다를 수 있지만 핵심은 같습니다. 호스트가 `npx`를 실행하고 환경 변수로 API key를 넘깁니다. Core URL은 기본적으로 `https://dory-to-dory.dnotitia.ai`를 사용하며, 다른 Core에 연결할 때만 `D2D_CORE_URL`로 재정의합니다. 패키지 버전을 고정하면 예기치 않은 자동 업데이트를 피할 수 있습니다.
 
-`pnpm dlx`를 쓰는 호스트라면 command를 `pnpm`, args를 `["dlx", "dory-to-dory-mcp@0.1.4"]`로 바꿉니다.
+`pnpm dlx`를 쓰는 호스트라면 command를 `pnpm`, args를 `["dlx", "dory-to-dory-mcp@0.2.0"]`로 바꿉니다.
 
-## 게시 전 로컬 설치
+## 로컬 소스 또는 tarball 설치
 
 ```sh
 pnpm install
@@ -82,7 +102,7 @@ MCP 호스트 설정:
 또는 `pnpm pack`으로 생성한 `.tgz` 파일을 다른 장비에 전달해 설치할 수 있습니다.
 
 ```sh
-npm install --global ./dory-to-dory-mcp-0.1.4.tgz
+npm install --global ./dory-to-dory-mcp-0.2.0.tgz
 ```
 
 이후 MCP command를 `d2d-mcp`로 설정합니다.