Coder/deepseek-harness
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

chore(cordis): regenerate service catalog for user-interaction JSDoc

Browse Source
This commit is contained in:
Tianyi Cui
2026-08-02 11:45:33 +08:00
parent 8d92a9bdaa
commit 46d8d97efe
2 changed files with 8 additions and 1 deletions
Download Patch File Download Diff File Expand all files Collapse all files

7
docs/cordis-catalog/services.md
View File

@@ -2445,8 +2445,15 @@ registerProvider(provider: UserInteractionProvider): () => void
/** /**
* Ask the active UI provider and wait for the user's answer. * Ask the active UI provider and wait for the user's answer.
* *
* Human-interaction requests are only valid from a top-level agent: a
* delegated subagent has no human answerer in its own context, so asking
* there would block forever. This mirrors the goal tools' top-level-only
* authority (`create_goal` rejects non-top-level agents).
*
* @param request Questions, owner agent, and abort signal. * @param request Questions, owner agent, and abort signal.
* @returns The answer chosen or typed by the human. * @returns The answer chosen or typed by the human.
* @throws {UserInteractionError} code `DELEGATED_CALLER` when the calling
* agent is a delegated subagent (`session.header.delegationDepth > 0`).
*/ */
async ask(request: AskUserQuestionRequest): Promise<AskUserQuestionAnswer> async ask(request: AskUserQuestionRequest): Promise<AskUserQuestionAnswer>
``` ```

2
packages/cordis/tool-cordis/src/api-catalog.ts
View File

@@ -1114,7 +1114,7 @@ export const SERVICE_API: readonly ServiceApiEntry[] = [
}, },
{ {
signature: 'async ask(request: AskUserQuestionRequest): Promise<AskUserQuestionAnswer>', signature: 'async ask(request: AskUserQuestionRequest): Promise<AskUserQuestionAnswer>',
jsDoc: '/**\n * Ask the active UI provider and wait for the user\'s answer.\n *\n * @param request Questions, owner agent, and abort signal.\n * @returns The answer chosen or typed by the human.\n */', jsDoc: '/**\n * Ask the active UI provider and wait for the user\'s answer.\n *\n * Human-interaction requests are only valid from a top-level agent: a\n * delegated subagent has no human answerer in its own context, so asking\n * there would block forever. This mirrors the goal tools\' top-level-only\n * authority (`create_goal` rejects non-top-level agents).\n *\n * @param request Questions, owner agent, and abort signal.\n * @returns The answer chosen or typed by the human.\n * @throws {UserInteractionError} code `DELEGATED_CALLER` when the calling\n * agent is a delegated subagent (`session.header.delegationDepth > 0`).\n */',
}, },
], ],
}, },