dory-to-dory-mcp 0.3.0 → 0.5.0

package/README.md

@@ -11,15 +11,15 @@
 - lease/fencing token이 있는 work claim, 사용자 확인, host 갱신과 client 응답 제출
 - 참여자별 nullable session 연결과 revision 기반 명시적 이동·해제
 - Core API key 기반 인증
-- MCP Tools 21개 제공
+- MCP Tools 22개 제공
 
-버전 `0.3.0`은 검색 증빙 발급 API `POST /v2/agent/skill-searches`를 지원하는 Core `/v2` 계약이 필요합니다. 호환 Core를 먼저 적용하고 정확한 MCP 버전을 고정해 설치하십시오. npm 게시 전 검증이나 사내 배포에는 로컬 빌드 또는 tarball을 사용할 수 있습니다. 구형 `/v1` 쓰기를 새 계약으로 자동 변환하지 않으며 진행 중인 구형 작업에는 기존 MCP 버전을 사용합니다.
+버전 `0.5.0`은 검색 증빙 발급 API, 실행 담당자 규약 2와 `execution_result` 보고를 지원하는 Core `/v2` 계약이 필요합니다. Core migration `9b3c7d5e102a`와 `schedule_meeting 1.2.0`을 제공하는 Core를 먼저 적용해야 합니다. 기존 Skill snapshot과 receipt 모드의 계약은 유지합니다. 호환 Core를 먼저 적용하고 정확한 MCP 버전을 고정해 설치하십시오. npm 게시 전 검증이나 사내 배포에는 로컬 빌드 또는 tarball을 사용할 수 있습니다. 구형 `/v1` 쓰기를 새 계약으로 자동 변환하지 않으며 진행 중인 구형 작업에는 기존 MCP 버전을 사용합니다.
 
 ### 카드와 세션 도구
 
 `d2d_create_coordination`은 `client_handles`, `goal`, `skill_search_id`를 받습니다. `goal_type`은 제거했습니다. 매 새 coordination 생성 전에 `d2d_search_coordination_skills`를 동일한 goal로 최소 한 번 정상 완료해야 합니다. 검색 도구는 `POST /v2/agent/skill-searches`로 증빙을 발급받으며 검색 입력은 `goal`(필수), `query`(최대 200자, 기본 빈 문자열), `operation_id`(선택)입니다. 반환된 `skill_search_id`를 생성에 전달합니다. 관련 후보는 `d2d_get_coordination_skill`로 조건·계획 템플릿·정확한 버전을 확인한 뒤 plan을 작성합니다. 적합한 후보가 없으면 skill 없이 직접 계획하며, Core는 실제 검색 완료 증빙의 호출자·goal·만료·일회 사용을 검증합니다. 결과가 0건이거나 LLM이 유효한 Skill이 없다고 판단하면 `skill=null`로 생성할 수 있습니다. 검색 결과나 선택 판단은 검토하지 않습니다. 검색 오류는 최초 1회와 최대 3회 재시도, 총 4회 HTTP 요청으로 제한하고 `D2D_MAX_RETRIES`와 중첩하지 않습니다. HTTP 408을 포함한 검색 오류를 재시도하되, Core가 명시한 `skill_search_exhausted`·`idempotency_conflict`는 즉시 종료합니다. 동일 `operation_id`와 goal/query의 실행 중·성공·실패 결과는 MCP 프로세스에서 공유하므로 중복·동시 도구 호출로 HTTP 재시도 예산을 초기화할 수 없습니다. 같은 키에 다른 입력은 충돌로 거부합니다. Core는 프로세스 재시작 뒤에도 실제 검색 횟수를 DB에서 제한하지만 Core에 도달하지 않은 전송 오류 횟수는 MCP 프로세스 안에서만 유지됩니다. 실패하면 생성도 종료하며 새 `operation_id`로 예산을 초기화하지 않습니다. 검색 결과의 `operation_id`를 보존하고, 생성은 생략 시 `skill_search_id`를 idempotency key로 사용하므로 불명확한 응답에는 동일 payload와 key를 재사용합니다. `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를 확인해야 완료할 수 있습니다.
+`d2d_claim_next_item` 결과의 `delivery.work.claim_id`와 카드 revision을 사용합니다. claim 응답에는 skill 본문을 포함하지 않습니다. Host는 `d2d_get_coordination`으로 저장된 skill을 조회할 수 있고, Client는 자기 요청에 포함된 참조를 사용합니다. Skill 조회에는 정확한 version이 필수입니다. client는 `d2d_submit_item_result`의 `to_host`만 제출하고 다른 카드 필드는 거부됩니다. host는 `d2d_update_host_card`로 plan, slots, 상태 및 다음 요청을 결정합니다. 회의 commit은 같은 proposal에 전원 준비가 확인된 뒤 host가 결정합니다. 새 agent_report 모드는 실제 실행 결과를 보고해 완료하며 외부 ID나 별도 검증을 요구하지 않습니다. 기존 receipt 모드는 이전 계약을 유지합니다.
 
 생성·claim·결과·host 갱신·사용자 답변에는 현재 `session_id`를 전달할 수 있습니다. 외부 Agent는 `null` 또는 생략을 사용할 수 있으며 기존 연결은 유지됩니다. 명시적 이동·해제는 `d2d_bind_session`에 `expected_session_revision`과 문자열 또는 `null`을 전달합니다. 각 Agent는 자기 연결만 접근합니다. 사용자 답변은 `interaction_id`, `answer`, 승인 질문인 경우 명시적 `decision`으로 제출합니다.
 
@@ -27,6 +27,15 @@ MCP Resources, Prompts, 알림 push, polling daemon, FCM, Runtime Adapter는 포
 
 Agent가 dory-to-dory의 목적, Watcher 설치와 device pairing, SSE 처리, 사용자 확인, 허용 범위와 일반적인 처리 흐름을 설명해야 할 때는 파라미터 없이 `d2d_get_usage_guide`를 호출할 수 있습니다.
 
+## 작업 인계와 사용자 질문
+
+새 Core의 `execution_protocol=2` coordination은 `Host → 한 Client → Host` 순서로 진행합니다. Host만 카드 상태·계획·slots를 결정하며 Client는 필요한 정보를 모은 뒤 최종 `to_host`만 제출합니다.
+
+- Host 중간 저장: `d2d_update_host_card`의 `next_action=continue`는 같은 claim을 유지합니다. 다음 Client 한 명에게 요청할 때 `dispatch`, 최종 완료·실패·취소를 결정할 때 `finish`를 사용합니다.
+- 사용자 질문: 현재 담당 Host 또는 Client가 `d2d_request_user_input`에 `work_id`, `claim_id`, `question`을 전달합니다. Core는 같은 작업을 `waiting_for_input`으로 보존하고 claim을 해제합니다. 카드 업무 상태와 담당자는 유지하며 Client 응답이나 Host 검토는 발생하지 않습니다.
+- 재개: 명시적인 답변을 `d2d_submit_user_response`로 기록하고, 같은 `work_id`를 다시 claim해 새 `claim_id`와 현재 revision으로 계속합니다. 질문이 더 필요하면 같은 작업에서 반복합니다. 외부 동작의 승인·commit·현재 작업 연결은 유지하며, 결과 입력은 coordination.result_mode에 맞춰 선택합니다.
+- 호환성: `ask_user` Client 결과와 사용자 대기 카드 상태는 `execution_protocol=1`인 기존 건에서만 사용합니다. 새 질문·인계 기능은 이를 지원하는 Core, MCP, Agent와 Watcher를 함께 배포해야 합니다.
+
 ## 요구 사항
 
 - Node.js 22 이상
@@ -35,18 +44,18 @@ Agent가 dory-to-dory의 목적, Watcher 설치와 device pairing, SSE 처리,
 
 ## Watcher를 통한 설치
 
-Watcher `0.2.0`에는 MCP `0.2.0`이 고정되어 있습니다. 검색 증빙이 필수인 Core에서 새 coordination을 생성하려면 MCP `0.3.0`을 포함한 Watcher `0.3.0` 릴리스가 필요합니다. Watcher는 별도 게시 단위입니다. 해당 버전이 registry에 게시되기 전에는 검증된 Dory 앱 번들 또는 아래의 MCP 직접 등록 방식으로 새 MCP를 실행합니다. 기존 Watcher 설치의 의존성은 자동으로 바뀌지 않습니다.
+새 실행 결과 보고에는 MCP `0.5.0`을 포함한 Watcher `0.5.0`을 사용합니다. Watcher `0.3.0` 이하에는 규약 2의 질문·인계 처리가 없고, `0.4.0`에는 새 실행 결과 입력과 지침이 없습니다. Watcher는 별도 게시 단위이므로 해당 버전의 registry 게시를 확인한 뒤 설치합니다. 기존 Watcher 설치의 의존성은 자동으로 바뀌지 않습니다.
 
-아래는 Watcher `0.3.0` 게시 후 사용할 설치 예시입니다. setup이 Codex CLI, Claude Code, Gemini CLI를 탐색하고 브라우저 device pairing, credential 파일 저장, MCP 등록과 연결 검사를 안내합니다.
+아래는 Watcher `0.5.0` 설치 예시입니다. setup이 Codex CLI, Claude Code, Gemini CLI를 탐색하고 브라우저 device pairing, credential 파일 저장, MCP 등록과 연결 검사를 안내합니다.
 
 ```sh
-npm install --global dory-to-dory-watcher@0.3.0
+npm install --global dory-to-dory-watcher@0.5.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은 재시도할 수 있게 유지합니다.
+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가 계속 실행할 수 있으면 더 안전한 대안을 찾거나 `d2d_request_user_input`으로 자기 사용자에게 질문하거나 `error`를 제출하고, 제출 전에 중단되면 Watcher가 안전한 장애 코드만 보고하며 item은 재시도할 수 있게 유지합니다.
 
 `dory-watcher doctor`는 Core와 Agent 로그인뿐 아니라 실제 무인 실행 모드도 검사합니다. Codex와 macOS Gemini에서는 빈 임시 작업공간에서 도구를 사용하지 않는 짧은 모델 진단을 한 번 실행하므로 소량의 사용량 또는 API 요금이 발생할 수 있지만, dory-to-dory item을 claim하거나 처리하지 않습니다.
 
@@ -63,7 +72,7 @@ Watcher는 Agent별로 지원되는 비대화식 승인과 격리 방식을 사
   "mcpServers": {
     "dory-to-dory": {
       "command": "npx",
-      "args": ["-y", "dory-to-dory-mcp@0.3.0"],
+      "args": ["-y", "dory-to-dory-mcp@0.5.0"],
       "env": {
         "D2D_API_KEY": "d2d_live_replace_me"
       }
@@ -74,7 +83,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.3.0"]`로 바꿉니다.
+`pnpm dlx`를 쓰는 호스트라면 command를 `pnpm`, args를 `["dlx", "dory-to-dory-mcp@0.5.0"]`로 바꿉니다.
 
 ## 로컬 소스 또는 tarball 설치
 
@@ -104,7 +113,7 @@ MCP 호스트 설정:
 또는 `pnpm pack`으로 생성한 `.tgz` 파일을 다른 장비에 전달해 설치할 수 있습니다.
 
 ```sh
-npm install --global ./dory-to-dory-mcp-0.3.0.tgz
+npm install --global ./dory-to-dory-mcp-0.5.0.tgz
 ```
 
 이후 MCP command를 `d2d-mcp`로 설정합니다.
@@ -145,3 +154,59 @@ pnpm run check
 ```
 
 배포 선택지와 운영상 제약은 [docs/deployment.md](docs/deployment.md)를 참고하십시오.
+
+
+## Execution results and precise tool inputs (0.5.0)
+
+New coordinations report `coordination.result_mode`. In `agent_report` mode, including
+`schedule_meeting@1.2.0`, each Agent reports its actual calendar outcome; no provider,
+event ID, receipt, separate verification phase, or mutual calendar inspection is
+required. Existing `receipt` mode coordinations retain their legacy receipt contract.
+This release requires Core migration `9b3c7d5e102a` and an Agent that reports actual
+execution outcomes. Existing 0.4.0 installations do not gain the new inputs or
+instructions automatically; update the exact MCP/Watcher package pins or the Dory app bundle.
+
+A Client answers a Core-issued commit with:
+
+```json
+{
+  "to_host": {
+    "type": "committed",
+    "message": "일정을 등록했습니다.",
+    "execution_result": {
+      "proposal_hash": "<current 64-character Core proposal hash>",
+      "operation_id": "<own to_client.operation_id>",
+      "status": "succeeded"
+    }
+  }
+}
+```
+
+Include the current `work_id`, `claim_id`, own card `expected_revision`, `request_id`,
+`turn_id`, and actual session in the full submission. Failed or uncertain execution
+is reported as `failed` or `unknown`, preserving earlier successes. A timeout must
+not become an assumed success or an automatic duplicate write. Host's own report
+goes in `host_execution_result`; `host_attends=false` needs no Host calendar write.
+Use exactly one execution result or legacy receipt, including late recovery reports.
+The nested operation ID identifies the committed operation; the top-level
+`operation_id` is only the tool request's replay key.
+
+`ready` still requires valid **`to_host.approval`**, and only answers `prepare`.
+`source=user` needs a real answered Core confirmation for the saved proposal;
+`source=policy` needs the current own policy version. An information `answer` does
+not carry approval. Ask approval only after saving the proposal; `proposed_action`
+is display text, not a proposal setter. Choice questions require nonempty choices,
+and the submitted answer must exactly equal an offered string.
+
+Tool schemas now publish response, approval, question, result and terminal-input
+conditions. Host `finish` requires terminal `state`, `reason` and `reason_code`;
+completion also needs all Client cards complete, all plan steps complete/skipped,
+no unreviewed responses and all required execution successes. `plan` and `slots`
+replace the entire collection when supplied. Cancellation requests stop execution
+and require Host cleanup before the final business state is settled.
+
+`d2d_get_coordination_skill` now requires an exact `version`. Only Host can inspect
+the saved workflow skill; Client uses the exact reference supplied in its request.
+In a fresh conversation without the original work ID, resume an answered question
+by claiming within its returned `coordination_id`. `d2d_bind_session` requires
+`session_id`; explicit null clears, whereas ordinary submissions' null preserves.

package/contracts/core-openapi.json

@@ -4576,6 +4576,85 @@
         }
       }
     },
+    "/v2/agent/work/{work_id}/question": {
+      "post": {
+        "tags": [
+          "workflows-v2"
+        ],
+        "summary": "Request Work Question",
+        "operationId": "request_work_question_v2_agent_work__work_id__question_post",
+        "parameters": [
+          {
+            "name": "work_id",
+            "in": "path",
+            "required": true,
+            "schema": {
+              "type": "string",
+              "title": "Work Id"
+            }
+          },
+          {
+            "name": "Idempotency-Key",
+            "in": "header",
+            "required": true,
+            "schema": {
+              "type": "string",
+              "minLength": 8,
+              "maxLength": 128,
+              "title": "Idempotency-Key"
+            }
+          },
+          {
+            "name": "authorization",
+            "in": "header",
+            "required": false,
+            "schema": {
+              "anyOf": [
+                {
+                  "type": "string"
+                },
+                {
+                  "type": "null"
+                }
+              ],
+              "title": "Authorization"
+            }
+          }
+        ],
+        "requestBody": {
+          "required": true,
+          "content": {
+            "application/json": {
+              "schema": {
+                "$ref": "#/components/schemas/WorkQuestionRequest"
+              }
+            }
+          }
+        },
+        "responses": {
+          "200": {
+            "description": "Successful Response",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/WorkQuestionResult"
+                }
+              }
+            }
+          },
+          "422": {
+            "description": "Validation Error",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/HTTPValidationError"
+                }
+              }
+            }
+          }
+        }
+      }
+    },
     "/v2/agent/interactions": {
       "get": {
         "tags": [
@@ -4995,7 +5074,7 @@
             "required": false,
             "schema": {
               "type": "string",
-              "default": "1.0.0",
+              "default": "1.2.0",
               "title": "Version"
             }
           },
@@ -6451,6 +6530,16 @@
                 "type": "null"
               }
             ]
+          },
+          "execution_result": {
+            "anyOf": [
+              {
+                "$ref": "#/components/schemas/ExecutionResult"
+              },
+              {
+                "type": "null"
+              }
+            ]
           }
         },
         "additionalProperties": false,
@@ -7074,6 +7163,54 @@
         ],
         "title": "ExecutionReceipt"
       },
+      "ExecutionResult": {
+        "properties": {
+          "proposal_hash": {
+            "type": "string",
+            "maxLength": 64,
+            "minLength": 64,
+            "title": "Proposal Hash",
+            "description": "Current committed proposal hash."
+          },
+          "operation_id": {
+            "type": "string",
+            "maxLength": 128,
+            "minLength": 8,
+            "title": "Operation Id",
+            "description": "Core-issued participant execution operation."
+          },
+          "status": {
+            "type": "string",
+            "enum": [
+              "succeeded",
+              "failed",
+              "unknown"
+            ],
+            "title": "Status"
+          },
+          "reason": {
+            "anyOf": [
+              {
+                "type": "string",
+                "maxLength": 2000
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "title": "Reason"
+          }
+        },
+        "additionalProperties": false,
+        "type": "object",
+        "required": [
+          "proposal_hash",
+          "operation_id",
+          "status"
+        ],
+        "title": "ExecutionResult",
+        "description": "The owning Agent's report; external provider identifiers are not required."
+      },
       "FriendInviteCreate": {
         "properties": {
           "handle": {
@@ -7325,6 +7462,16 @@
               }
             ]
           },
+          "host_execution_result": {
+            "anyOf": [
+              {
+                "$ref": "#/components/schemas/ExecutionResult"
+              },
+              {
+                "type": "null"
+              }
+            ]
+          },
           "commit": {
             "type": "boolean",
             "title": "Commit",
@@ -7415,6 +7562,22 @@
               }
             ],
             "title": "Claim Id"
+          },
+          "next_action": {
+            "anyOf": [
+              {
+                "type": "string",
+                "enum": [
+                  "continue",
+                  "dispatch",
+                  "finish"
+                ]
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "title": "Next Action"
           }
         },
         "additionalProperties": false,
@@ -8041,7 +8204,24 @@
       "RecoveryReceipt": {
         "properties": {
           "receipt": {
-            "$ref": "#/components/schemas/ExecutionReceipt"
+            "anyOf": [
+              {
+                "$ref": "#/components/schemas/ExecutionReceipt"
+              },
+              {
+                "type": "null"
+              }
+            ]
+          },
+          "execution_result": {
+            "anyOf": [
+              {
+                "$ref": "#/components/schemas/ExecutionResult"
+              },
+              {
+                "type": "null"
+              }
+            ]
           },
           "session_id": {
             "anyOf": [
@@ -8060,9 +8240,6 @@
         },
         "additionalProperties": false,
         "type": "object",
-        "required": [
-          "receipt"
-        ],
         "title": "RecoveryReceipt"
       },
       "SessionBindRequest": {
@@ -8985,6 +9162,56 @@
         ],
         "title": "WorkDelivery"
       },
+      "WorkQuestionRequest": {
+        "properties": {
+          "claim_id": {
+            "type": "string",
+            "title": "Claim Id"
+          },
+          "question": {
+            "$ref": "#/components/schemas/WorkflowQuestion"
+          },
+          "session_id": {
+            "anyOf": [
+              {
+                "type": "string",
+                "maxLength": 256,
+                "minLength": 1,
+                "pattern": "^[^\\s\\x00-\\x1f\\x7f]+$"
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "title": "Session Id"
+          }
+        },
+        "additionalProperties": false,
+        "type": "object",
+        "required": [
+          "claim_id",
+          "question"
+        ],
+        "title": "WorkQuestionRequest"
+      },
+      "WorkQuestionResult": {
+        "properties": {
+          "work": {
+            "$ref": "#/components/schemas/WorkView"
+          },
+          "interaction": {
+            "additionalProperties": true,
+            "type": "object",
+            "title": "Interaction"
+          }
+        },
+        "type": "object",
+        "required": [
+          "work",
+          "interaction"
+        ],
+        "title": "WorkQuestionResult"
+      },
       "WorkResultRequest": {
         "properties": {
           "claim_id": {
@@ -9110,6 +9337,17 @@
               }
             ],
             "title": "Claim Expires At"
+          },
+          "interaction_id": {
+            "anyOf": [
+              {
+                "type": "string"
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "title": "Interaction Id"
           }
         },
         "type": "object",
@@ -9264,6 +9502,18 @@
             ],
             "title": "Receipt"
           },
+          "execution_result": {
+            "anyOf": [
+              {
+                "additionalProperties": true,
+                "type": "object"
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "title": "Execution Result"
+          },
           "recovery_receipts": {
             "items": {
               "additionalProperties": true,
@@ -9271,6 +9521,14 @@
             },
             "type": "array",
             "title": "Recovery Receipts"
+          },
+          "recovery_results": {
+            "items": {
+              "additionalProperties": true,
+              "type": "object"
+            },
+            "type": "array",
+            "title": "Recovery Results"
           }
         },
         "type": "object",
@@ -9302,6 +9560,31 @@
             "title": "Schema Version",
             "default": 2
           },
+          "execution_protocol": {
+            "type": "integer",
+            "title": "Execution Protocol",
+            "default": 1
+          },
+          "result_mode": {
+            "type": "string",
+            "enum": [
+              "agent_report",
+              "receipt"
+            ],
+            "title": "Result Mode",
+            "default": "receipt"
+          },
+          "owner_card_id": {
+            "anyOf": [
+              {
+                "type": "string"
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "title": "Owner Card Id"
+          },
           "role": {
             "type": "string",
             "enum": [
@@ -9703,6 +9986,31 @@
             "title": "Schema Version",
             "default": 2
           },
+          "execution_protocol": {
+            "type": "integer",
+            "title": "Execution Protocol",
+            "default": 1
+          },
+          "result_mode": {
+            "type": "string",
+            "enum": [
+              "agent_report",
+              "receipt"
+            ],
+            "title": "Result Mode",
+            "default": "receipt"
+          },
+          "owner_card_id": {
+            "anyOf": [
+              {
+                "type": "string"
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "title": "Owner Card Id"
+          },
           "role": {
             "type": "string",
             "enum": [
@@ -9924,6 +10232,13 @@
             },
             "type": "array",
             "title": "Pending Work"
+          },
+          "owned_work": {
+            "items": {
+              "$ref": "#/components/schemas/WorkView"
+            },
+            "type": "array",
+            "title": "Owned Work"
           }
         },
         "type": "object",

package/dist/core-client.d.ts

@@ -18,6 +18,8 @@ export type CoordinationCreate = Omit<Schemas["WorkflowCreate"], "skill_search_i
 export type HostUpdate = Schemas["HostUpdate"];
 export type SessionBindRequest = Schemas["SessionBindRequest"];
 export type WorkClaimRequest = Schemas["WorkClaimRequest"];
+export type WorkQuestionRequest = Schemas["WorkQuestionRequest"];
+export type WorkQuestionResult = Schemas["WorkQuestionResult"];
 export type SkillRunRequest = Schemas["SkillRunRequest"];
 export type RecoveryReceipt = Schemas["RecoveryReceipt"];
 export type CoordinationSkill = Schemas["CoordinationSkill"];
@@ -73,6 +75,7 @@ export declare class CoreClient {
     checkActionableItems(limit?: number): Promise<ActionableItems>;
     submitItemResult(itemId: string, result: ItemResultRequest, operationId?: string): Promise<Coordination>;
     acknowledgeItem(workId: string, claimId: string, operationId?: string): Promise<Item>;
+    requestUserInput(workId: string, input: WorkQuestionRequest, operationId?: string): Promise<WorkQuestionResult>;
     submitUserResponse(interactionId: string, response: ItemUserResponseRequest, operationId?: string): Promise<Record<string, unknown>>;
     recordRecoveryReceipt(coordinationId: string, input: RecoveryReceipt, operationId?: string): Promise<{
         recorded: boolean;

package/dist/core-client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"core-client.d.ts","sourceRoot":"","sources":["../src/core-client.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"core-client.d.ts","sourceRoot":"","sources":["../src/core-client.ts"],"names":[],"mappings":"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"}

package/dist/core-client.js

@@ -174,6 +174,9 @@ export class CoreClient {
     acknowledgeItem(workId, claimId, operationId = randomUUID()) {
         return this.write(`/v2/agent/work/${encodeURIComponent(workId)}/ack`, { claim_id: claimId }, operationId);
     }
+    requestUserInput(workId, input, operationId = randomUUID()) {
+        return this.write(`/v2/agent/work/${encodeURIComponent(workId)}/question`, input, operationId);
+    }
     submitUserResponse(interactionId, response, operationId = randomUUID()) {
         return this.write(`/v2/agent/interactions/${encodeURIComponent(interactionId)}/response`, response, operationId);
     }