dory-to-dory-mcp 0.2.0 → 0.4.0

package/README.md

@@ -11,13 +11,13 @@
 - lease/fencing token이 있는 work claim, 사용자 확인, host 갱신과 client 응답 제출
 - 참여자별 nullable session 연결과 revision 기반 명시적 이동·해제
 - Core API key 기반 인증
-- MCP Tools 21개 제공
+- MCP Tools 22개 제공
 
-버전은 `0.2.0`이며 Core `/v2` 계약이 필요합니다. npm에서 정확한 버전을 고정해 설치하거나 검증한 tarball을 사용할 수 있습니다. 구형 `/v1` 쓰기를 새 계약으로 자동 변환하지 않으며 진행 중인 구형 작업에는 기존 MCP 버전을 사용합니다.
+버전 `0.4.0`은 검색 증빙 발급 API와 실행 담당자 규약 2를 지원하는 Core `/v2` 계약이 필요합니다. `POST /v2/agent/work/{work_id}/question`, 단일 담당자 인계, 같은 work 재개를 지원하는 Core migration을 먼저 적용해야 합니다. 호환 Core를 먼저 적용하고 정확한 MCP 버전을 고정해 설치하십시오. 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_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를 확인해야 완료할 수 있습니다.
 
@@ -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·receipt 검증은 그대로 적용됩니다.
+- 호환성: `ask_user` Client 결과와 사용자 대기 카드 상태는 `execution_protocol=1`인 기존 건에서만 사용합니다. 새 질문·인계 기능은 이를 지원하는 Core, MCP, Agent와 Watcher를 함께 배포해야 합니다.
+
 ## 요구 사항
 
 - Node.js 22 이상
@@ -35,16 +44,18 @@ Agent가 dory-to-dory의 목적, Watcher 설치와 device pairing, SSE 처리,
 
 ## Watcher를 통한 설치
 
-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를 별도로 설치할 필요가 없습니다.
+실행 담당자 규약 2를 사용하는 coordination에는 MCP `0.4.0`을 포함한 Watcher `0.4.0`이 필요합니다. Watcher `0.3.0` 이하의 기존 설치에는 새 질문 도구와 인계 처리가 없습니다. Watcher는 별도 게시 단위입니다. 해당 버전이 registry에 게시되기 전에는 검증된 Dory 앱 번들 또는 아래의 MCP 직접 등록 방식으로 새 MCP를 실행합니다. 기존 Watcher 설치의 의존성은 자동으로 바뀌지 않습니다.
+
+아래는 Watcher `0.4.0` 게시 후 사용할 설치 예시입니다. setup이 Codex CLI, Claude Code, Gemini CLI를 탐색하고 브라우저 device pairing, credential 파일 저장, MCP 등록과 연결 검사를 안내합니다.
 
 ```sh
-npm install --global dory-to-dory-watcher@0.2.0
+npm install --global dory-to-dory-watcher@0.4.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하거나 처리하지 않습니다.
 
@@ -54,14 +65,14 @@ Watcher는 Agent별로 지원되는 비대화식 승인과 격리 방식을 사
 
 ## 고급 사용자: MCP 직접 추가
 
-MCP 호스트 설정에 정확한 버전을 지정합니다.
+호환 Core와 MCP 패키지의 게시 여부를 확인한 뒤 호스트 설정에 정확한 버전을 지정합니다.
 
 ```json
 {
   "mcpServers": {
     "dory-to-dory": {
       "command": "npx",
-      "args": ["-y", "dory-to-dory-mcp@0.2.0"],
+      "args": ["-y", "dory-to-dory-mcp@0.4.0"],
       "env": {
         "D2D_API_KEY": "d2d_live_replace_me"
       }
@@ -72,7 +83,7 @@ MCP 호스트 설정에 정확한 버전을 지정합니다.
 
 호스트마다 설정 파일 위치와 최상위 키 이름은 다를 수 있지만 핵심은 같습니다. 호스트가 `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.2.0"]`로 바꿉니다.
+`pnpm dlx`를 쓰는 호스트라면 command를 `pnpm`, args를 `["dlx", "dory-to-dory-mcp@0.4.0"]`로 바꿉니다.
 
 ## 로컬 소스 또는 tarball 설치
 
@@ -102,7 +113,7 @@ MCP 호스트 설정:
 또는 `pnpm pack`으로 생성한 `.tgz` 파일을 다른 장비에 전달해 설치할 수 있습니다.
 
 ```sh
-npm install --global ./dory-to-dory-mcp-0.2.0.tgz
+npm install --global ./dory-to-dory-mcp-0.4.0.tgz
 ```
 
 이후 MCP command를 `d2d-mcp`로 설정합니다.
@@ -115,7 +126,7 @@ npm install --global ./dory-to-dory-mcp-0.2.0.tgz
 | `D2D_API_KEY` | 조건부 | - | Core가 발급한 Agent API key. `D2D_API_KEY_FILE`과 동시에 설정하지 않음 |
 | `D2D_API_KEY_FILE` | 조건부 | - | Agent API key 한 줄을 저장한 credential 파일. `D2D_API_KEY` 대신 사용 |
 | `D2D_REQUEST_TIMEOUT_SECONDS` | 아니요 | `15` | HTTP 요청 timeout |
-| `D2D_MAX_RETRIES` | 아니요 | `2` | GET 및 idempotent 쓰기 요청의 추가 재시도 횟수 |
+| `D2D_MAX_RETRIES` | 아니요 | `2` | GET 및 idempotent 쓰기 요청의 추가 재시도 횟수. 검색 증빙 요청은 별도 최대 3회로 고정 |
 
 API key는 tool input이나 stdout에 노출하지 않습니다. MCP 설정 파일의 권한을 제한하고, 유출 가능성이 있으면 Core 대시보드에서 즉시 키를 재발급하십시오.
 

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": [
@@ -4902,6 +4981,76 @@
         }
       }
     },
+    "/v2/agent/skill-searches": {
+      "post": {
+        "tags": [
+          "workflows-v2"
+        ],
+        "summary": "Search For Creation",
+        "operationId": "search_for_creation_v2_agent_skill_searches_post",
+        "parameters": [
+          {
+            "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/SkillSearchRequest"
+              }
+            }
+          }
+        },
+        "responses": {
+          "200": {
+            "description": "Successful Response",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/SkillSearchResult"
+                }
+              }
+            }
+          },
+          "422": {
+            "description": "Validation Error",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/HTTPValidationError"
+                }
+              }
+            }
+          }
+        }
+      }
+    },
     "/v2/agent/skills/{skill_id}": {
       "get": {
         "tags": [
@@ -5260,6 +5409,76 @@
         }
       }
     },
+    "/v2/dashboard/skill-searches": {
+      "post": {
+        "tags": [
+          "workflows-v2"
+        ],
+        "summary": "Dashboard Search Skills",
+        "operationId": "dashboard_search_skills_v2_dashboard_skill_searches_post",
+        "parameters": [
+          {
+            "name": "Idempotency-Key",
+            "in": "header",
+            "required": true,
+            "schema": {
+              "type": "string",
+              "minLength": 8,
+              "maxLength": 128,
+              "title": "Idempotency-Key"
+            }
+          },
+          {
+            "name": "d2d_session",
+            "in": "cookie",
+            "required": false,
+            "schema": {
+              "anyOf": [
+                {
+                  "type": "string"
+                },
+                {
+                  "type": "null"
+                }
+              ],
+              "title": "D2D Session"
+            }
+          }
+        ],
+        "requestBody": {
+          "required": true,
+          "content": {
+            "application/json": {
+              "schema": {
+                "$ref": "#/components/schemas/SkillSearchRequest"
+              }
+            }
+          }
+        },
+        "responses": {
+          "200": {
+            "description": "Successful Response",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/SkillSearchResult"
+                }
+              }
+            }
+          },
+          "422": {
+            "description": "Validation Error",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/HTTPValidationError"
+                }
+              }
+            }
+          }
+        }
+      }
+    },
     "/v2/dashboard/coordinations/{coordination_id}/cancel": {
       "post": {
         "tags": [
@@ -7275,6 +7494,22 @@
               }
             ],
             "title": "Claim Id"
+          },
+          "next_action": {
+            "anyOf": [
+              {
+                "type": "string",
+                "enum": [
+                  "continue",
+                  "dispatch",
+                  "finish"
+                ]
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "title": "Next Action"
           }
         },
         "additionalProperties": false,
@@ -8143,6 +8378,63 @@
         ],
         "title": "SkillRunRequest"
       },
+      "SkillSearchRequest": {
+        "properties": {
+          "goal": {
+            "type": "string",
+            "maxLength": 20000,
+            "minLength": 1,
+            "title": "Goal"
+          },
+          "query": {
+            "type": "string",
+            "maxLength": 200,
+            "title": "Query",
+            "default": ""
+          }
+        },
+        "additionalProperties": false,
+        "type": "object",
+        "required": [
+          "goal"
+        ],
+        "title": "SkillSearchRequest"
+      },
+      "SkillSearchResult": {
+        "properties": {
+          "skills": {
+            "items": {
+              "$ref": "#/components/schemas/CoordinationSkill"
+            },
+            "type": "array",
+            "title": "Skills"
+          },
+          "skill_search_id": {
+            "type": "string",
+            "title": "Skill Search Id"
+          },
+          "expires_at": {
+            "type": "string",
+            "format": "date-time",
+            "title": "Expires At"
+          },
+          "attempt_count": {
+            "type": "integer",
+            "maximum": 4.0,
+            "minimum": 1.0,
+            "title": "Attempt Count"
+          }
+        },
+        "additionalProperties": false,
+        "type": "object",
+        "required": [
+          "skills",
+          "skill_search_id",
+          "expires_at",
+          "attempt_count"
+        ],
+        "title": "SkillSearchResult"
+      },
       "TelegramConnectionView": {
         "properties": {
           "available": {
@@ -8788,6 +9080,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": {
@@ -8913,6 +9255,17 @@
               }
             ],
             "title": "Claim Expires At"
+          },
+          "interaction_id": {
+            "anyOf": [
+              {
+                "type": "string"
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "title": "Interaction Id"
           }
         },
         "type": "object",
@@ -9105,6 +9458,22 @@
             "title": "Schema Version",
             "default": 2
           },
+          "execution_protocol": {
+            "type": "integer",
+            "title": "Execution Protocol",
+            "default": 1
+          },
+          "owner_card_id": {
+            "anyOf": [
+              {
+                "type": "string"
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "title": "Owner Card Id"
+          },
           "role": {
             "type": "string",
             "enum": [
@@ -9306,6 +9675,20 @@
             "minLength": 1,
             "title": "Goal"
           },
+          "skill_search_id": {
+            "anyOf": [
+              {
+                "type": "string",
+                "maxLength": 36,
+                "minLength": 1
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "title": "Skill Search Id",
+            "description": "Successful, owned, unexpired search proof for this goal; required for every new v2 creation."
+          },
           "completion_criteria": {
             "items": {
               "type": "string"
@@ -9492,6 +9875,22 @@
             "title": "Schema Version",
             "default": 2
           },
+          "execution_protocol": {
+            "type": "integer",
+            "title": "Execution Protocol",
+            "default": 1
+          },
+          "owner_card_id": {
+            "anyOf": [
+              {
+                "type": "string"
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "title": "Owner Card Id"
+          },
           "role": {
             "type": "string",
             "enum": [
@@ -9713,6 +10112,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

@@ -12,14 +12,20 @@ export type ItemDelivery = Schemas["WorkDelivery"];
 export type WaitingItemDelivery = Record<string, unknown>;
 export type ItemResultRequest = Schemas["WorkResultRequest"];
 export type ItemUserResponseRequest = Schemas["WorkflowUserResponse"];
-export type CoordinationCreate = Schemas["WorkflowCreate"];
+export type CoordinationCreate = Omit<Schemas["WorkflowCreate"], "skill_search_id"> & {
+    skill_search_id: string;
+};
 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"];
 export type SkillCodeExecution = Schemas["SkillCodeExecution"];
+export type SkillSearchRequest = Schemas["SkillSearchRequest"];
+export type SkillSearchResponse = Schemas["SkillSearchResult"];
 export type ActionableNextAction = "ask_user" | "claim_pending" | "none";
 export interface ActionableItems {
     waiting_items: WaitingItemDelivery[];
@@ -36,6 +42,7 @@ export declare class CoreApiError extends Error {
 export declare class CoreClient {
     private readonly config;
     private readonly fetcher;
+    private readonly skillSearchOperations;
     constructor(config: AppConfig, fetcher?: typeof fetch);
     private request;
     getConnectionStatus(): Promise<AgentMe>;
@@ -68,11 +75,14 @@ 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;
         coordination_id: string;
     }>;
+    searchSkillsForCoordination(input: SkillSearchRequest, operationId: string): Promise<SkillSearchResponse>;
+    private performSkillSearch;
     searchSkills(query?: string): Promise<CoordinationSkill[]>;
     getSkill(skillId: string, version?: string): Promise<CoordinationSkill>;
     runSkillCode(skillId: string, input: SkillRunRequest, operationId?: string): Promise<SkillCodeExecution>;

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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"}