dory-to-dory-mcp 0.7.0 → 0.8.0

package/README.md

@@ -13,7 +13,7 @@
 - Core API key 기반 인증
 - MCP Tools 22개 제공
 
-버전 `0.7.0`은 검색 증빙 발급 API, 실행 담당자 규약 2와 `execution_result` 보고를 지원하는 Core `/v2` 계약이 필요합니다. Core migration `9b3c7d5e102a`와 `schedule_meeting 1.4.0`을 제공하는 Core를 먼저 적용해야 합니다. 기존 Skill snapshot과 receipt 모드의 계약은 유지합니다. 호환 Core를 먼저 적용하고 정확한 MCP 버전을 고정해 설치하십시오. npm 게시 전 검증이나 사내 배포에는 로컬 빌드 또는 tarball을 사용할 수 있습니다. 구형 `/v1` 쓰기를 새 계약으로 자동 변환하지 않으며 진행 중인 구형 작업에는 기존 MCP 버전을 사용합니다.
+버전 `0.8.0`은 검색 증빙 발급 API, 실행 담당자 규약 2와 `execution_result` 보고를 지원하는 Core `/v2` 계약이 필요합니다. Core migration `ac4d8e6f213b`, 실행 복구 API, `initial_proposal`과 `schedule_meeting 1.5.0`을 제공하는 Core를 먼저 적용해야 합니다. 기존 Skill snapshot과 receipt 모드의 계약은 유지합니다. 호환 Core를 먼저 적용하고 정확한 MCP 버전을 고정해 설치하십시오. npm 게시 전 검증이나 사내 배포에는 로컬 빌드 또는 tarball을 사용할 수 있습니다. 구형 `/v1` 쓰기를 새 계약으로 자동 변환하지 않으며 진행 중인 구형 작업에는 기존 MCP 버전을 사용합니다.
 
 ### 카드와 세션 도구
 
@@ -27,6 +27,10 @@ MCP Resources, Prompts, 알림 push, polling daemon, FCM, Runtime Adapter는 포
 
 Agent가 dory-to-dory의 목적, Watcher 설치와 device pairing, SSE 처리, 사용자 확인, 허용 범위와 일반적인 처리 흐름을 설명해야 할 때는 파라미터 없이 `d2d_get_usage_guide`를 호출할 수 있습니다.
 
+Host 업데이트의 최상위 필수값은 `coordination_id`와 `expected_revision=coordination.revision`입니다. Protocol 2에서는 현재 `work_id`·`claim_id`도 전달합니다. `client_updates` 안에는 각각 실제 Client 카드의 `card_id`와 별도 `expected_revision`이 필요합니다. `to_client`는 `message`가 있는 객체이며 `prepare`·`commit`에는 저장된 proposal hash가 필요합니다. 요청만 dispatch할 때 Client state는 생략합니다. 사용자 질문은 `d2d_request_user_input`으로 저장하며 업무 state를 waiting 상태로 바꾸지 않습니다. `continue_current_work`는 같은 실행에서 계속하라는 지시이고 성공한 `end_turn`에서만 다음 알림을 기다립니다. 스키마 오류는 인계 성공이 아닙니다. 호출 형태와 복구 방법은 `d2d_get_usage_guide`의 Host 예시를 참고하십시오.
+
+최종 제안이 정해졌으면 생성 입력의 선택적 `initial_proposal`에 포함할 수 있습니다. 이는 승인 자체가 아닙니다. 일반 MCP에는 모델이 제출할 수 있는 `host_preapproval_id` 입력이나 사전 승인 발급 도구가 없습니다. 실제 사용자 확인을 검증하는 런타임을 지원하지 않는 경우 사전 동의를 추가로 묻지 않고 생성 후 Host 동의를 한 번 받습니다. 지원 런타임이 연결한 같은 범위의 유효한 동의는 중복 확인을 줄이지만 Client 동의와 최종 commit을 대신하지 않습니다.
+
 ## 작업 인계와 사용자 질문
 
 새 Core의 `execution_protocol=2` coordination은 `Host → 한 Client → Host` 순서로 진행합니다. Host만 카드 상태·계획·slots를 결정하며 Client는 필요한 정보를 모은 뒤 최종 `to_host`만 제출합니다.
@@ -44,12 +48,12 @@ Agent가 dory-to-dory의 목적, Watcher 설치와 device pairing, SSE 처리,
 
 ## Watcher를 통한 설치
 
-새 실행 결과 보고에는 MCP `0.7.0`을 포함한 Watcher `0.7.0`을 사용합니다. Watcher `0.3.0` 이하에는 규약 2의 질문·인계 처리가 없고, `0.4.0`에는 새 실행 결과 입력과 지침이 없습니다. Watcher는 별도 게시 단위이므로 해당 버전의 registry 게시를 확인한 뒤 설치합니다. 기존 Watcher 설치의 의존성은 자동으로 바뀌지 않습니다.
+새 실행 결과 보고에는 MCP `0.8.0`을 포함한 Watcher `0.8.0`을 사용합니다. Watcher `0.3.0` 이하에는 규약 2의 질문·인계 처리가 없고, `0.4.0`에는 새 실행 결과 입력과 지침이 없습니다. Watcher는 별도 게시 단위이므로 해당 버전의 registry 게시를 확인한 뒤 설치합니다. 기존 Watcher 설치의 의존성은 자동으로 바뀌지 않습니다.
 
-아래는 Watcher `0.7.0` 설치 예시입니다. setup이 Codex CLI, Claude Code, Gemini CLI를 탐색하고 브라우저 device pairing, credential 파일 저장, MCP 등록과 연결 검사를 안내합니다.
+아래는 Watcher `0.8.0` 설치 예시입니다. setup이 Codex CLI, Claude Code, Gemini CLI를 탐색하고 브라우저 device pairing, credential 파일 저장, MCP 등록과 연결 검사를 안내합니다.
 
 ```sh
-npm install --global dory-to-dory-watcher@0.7.0
+npm install --global dory-to-dory-watcher@0.8.0
 dory-watcher setup
 ```
 
@@ -72,7 +76,7 @@ Watcher는 Agent별로 지원되는 비대화식 승인과 격리 방식을 사
   "mcpServers": {
     "dory-to-dory": {
       "command": "npx",
-      "args": ["-y", "dory-to-dory-mcp@0.7.0"],
+      "args": ["-y", "dory-to-dory-mcp@0.8.0"],
       "env": {
         "D2D_API_KEY": "d2d_live_replace_me"
       }
@@ -83,7 +87,7 @@ Watcher는 Agent별로 지원되는 비대화식 승인과 격리 방식을 사
 
 호스트마다 설정 파일 위치와 최상위 키 이름은 다를 수 있지만 핵심은 같습니다. 호스트가 `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.7.0"]`로 바꿉니다.
+`pnpm dlx`를 쓰는 호스트라면 command를 `pnpm`, args를 `["dlx", "dory-to-dory-mcp@0.8.0"]`로 바꿉니다.
 
 ## 로컬 소스 또는 tarball 설치
 
@@ -113,7 +117,7 @@ MCP 호스트 설정:
 또는 `pnpm pack`으로 생성한 `.tgz` 파일을 다른 장비에 전달해 설치할 수 있습니다.
 
 ```sh
-npm install --global ./dory-to-dory-mcp-0.7.0.tgz
+npm install --global ./dory-to-dory-mcp-0.8.0.tgz
 ```
 
 이후 MCP command를 `d2d-mcp`로 설정합니다.
@@ -127,6 +131,7 @@ npm install --global ./dory-to-dory-mcp-0.7.0.tgz
 | `D2D_API_KEY_FILE` | 조건부 | - | Agent API key 한 줄을 저장한 credential 파일. `D2D_API_KEY` 대신 사용 |
 | `D2D_REQUEST_TIMEOUT_SECONDS` | 아니요 | `15` | HTTP 요청 timeout |
 | `D2D_MAX_RETRIES` | 아니요 | `2` | GET 및 idempotent 쓰기 요청의 추가 재시도 횟수. 검색 증빙 요청은 별도 최대 3회로 고정 |
+| `D2D_EXECUTION_RUN_ID` | 아니요 | 없음 | Watcher가 등록한 이번 실행의 UUID. 현재 프로세스 claim에만 주입하며 모델 입력이나 고정 MCP 설정에 넣지 않음 |
 
 API key는 tool input이나 stdout에 노출하지 않습니다. MCP 설정 파일의 권한을 제한하고, 유출 가능성이 있으면 Core 대시보드에서 즉시 키를 재발급하십시오.