From 7301fa98b07af8b21164aa6efbfdfa3c24ccbdce Mon Sep 17 00:00:00 2001 From: Dudu-0223 Date: Thu, 29 Oct 2026 14:56:27 +0800 Subject: [PATCH] fix(subagent): state when to query child routes and when to omit them The discovery tool presented itself as the place to inspect options before selecting a child route, and rejected every provider or model outside the Session's authorized routes, including providers that do not exist. A model that skipped the no-argument call therefore had no way to learn the correct ids or that omission was legal, and repeated identical denials. Say that queries exist to override the child route, that omitting both route fields inherits the parent route, that a field is omitted rather than sent empty, and, in each optional route field, that omitting it inherits the parent value. --- docs/tool-catalog.i18n.yaml | 2 +- docs/tool-catalog.md | 2 +- packages/subagent/tool-subagent/README.i18n.yaml | 4 ++-- packages/subagent/tool-subagent/README.md | 2 +- packages/subagent/tool-subagent/README.zh.md | 2 +- packages/subagent/tool-subagent/src/index.ts | 6 +++--- .../subagent/tool-subagent/src/list-models.ts | 7 ++++--- .../tool-subagent/tests/model-selection.spec.ts | 2 +- .../tool-schemas.expected.json | 8 ++++---- .../tool-schemas.expected.json | 16 ++++++++-------- .../fresh-round-trip/tool-schemas.expected.json | 8 ++++---- .../system-prompt.expected.md | 8 ++++---- .../system-prompt.expected.md | 8 ++++---- .../tool-schemas.expected.json | 16 ++++++++-------- .../web/ptc-round/system-prompt.expected.md | 8 ++++---- 15 files changed, 50 insertions(+), 49 deletions(-) diff --git a/docs/tool-catalog.i18n.yaml b/docs/tool-catalog.i18n.yaml index 880989b55c..63c69573ff 100644 --- a/docs/tool-catalog.i18n.yaml +++ b/docs/tool-catalog.i18n.yaml @@ -246,7 +246,7 @@ en: 841abe0dd5913ea7 zh: 841abe0dd5913ea7 /tool-schema-catalog/deepseek-ai-dsh-tool-subagent/list-subagent-models: - en: 207228068bc61885 + en: 2f6d3f253af50d47 zh: 36e9344ee1af8869 /tool-schema-catalog/deepseek-ai-dsh-tool-subagent/subagent: en: 430672da3c1a6ca6 diff --git a/docs/tool-catalog.md b/docs/tool-catalog.md index 1dea12b08f..a023eede44 100644 --- a/docs/tool-catalog.md +++ b/docs/tool-catalog.md @@ -2039,7 +2039,7 @@ The subagent_oar tool selects among configured aliases for external providers. T ### `list_subagent_models` -Inspect subagent models without changing the current Agent. No arguments: providers; `provider`: allowed models; `provider` + `model`: that model and its reasoning efforts. Inspect options here before selecting a child provider and model; use returned ids for delegation. +Inspect the subagent routes this Session authorizes. No arguments: authorized providers. `provider`: that provider's authorized models. `provider` + `model`: that model and its reasoning efforts. Query only to override the child route; delegation without `provider` and `model` inherits the parent route. Omit a field rather than sending an empty string. ```json { diff --git a/packages/subagent/tool-subagent/README.i18n.yaml b/packages/subagent/tool-subagent/README.i18n.yaml index 149d500b8d..77675a8d01 100644 --- a/packages/subagent/tool-subagent/README.i18n.yaml +++ b/packages/subagent/tool-subagent/README.i18n.yaml @@ -69,8 +69,8 @@ en: a4ca31b9cbacda6b zh: 91ac3e0784a14697 /deepseek-ai-dsh-tool-subagent/model-experience/model-selection-and-discovery/what-the-model-sees: - en: 8e6d560368799559 - zh: c379e1693f0ce891 + en: 931f00959c645b2b + zh: 9efdef9e7ad6bbc6 /deepseek-ai-dsh-tool-subagent/model-experience/model-selection-and-discovery/token-effect: en: 3a55d6616c00746b zh: 4b0ef3dbff2c67ce diff --git a/packages/subagent/tool-subagent/README.md b/packages/subagent/tool-subagent/README.md index 887268db23..b5881f9a13 100644 --- a/packages/subagent/tool-subagent/README.md +++ b/packages/subagent/tool-subagent/README.md @@ -153,7 +153,7 @@ Prefix-stable while provider instances and their configuration are unchanged. Ad #### What the model sees -The optional `list_subagent_models` definition reads the calling Session’s route policy, falling back to the current parent route when no policy is recorded. Calls reject while the optional `ctx.llm` service is unavailable. With a recorded policy, provider model lists intersect the advertised catalog with the Session’s authorized routes. Without one, they resolve only the current parent model, even if the catalog omits it. The discovery tool’s own description instructs the model to query options before selecting a child route; omitting or filtering out discovery removes that guidance. Exact-model queries accept authorized ids absent from the catalog; unauthorized provider/model lookups fail before adapter access. Catalog or exact-model lookup failures and cancellation reject the call. Execution independently enforces the same policy. +The optional `list_subagent_models` definition reads the calling Session’s route policy, falling back to the current parent route when no policy is recorded. Calls reject while the optional `ctx.llm` service is unavailable. With a recorded policy, provider model lists intersect the advertised catalog with the Session’s authorized routes. Without one, they resolve only the current parent model, even if the catalog omits it. The discovery tool’s own description tells the model to query only when overriding the child route, that delegation without route fields inherits the parent route, and that fields are omitted rather than sent empty; omitting or filtering out discovery removes that guidance. Exact-model queries accept authorized ids absent from the catalog; unauthorized provider/model lookups fail before adapter access. Catalog or exact-model lookup failures and cancellation reject the call. Execution independently enforces the same policy. #### Token effect diff --git a/packages/subagent/tool-subagent/README.zh.md b/packages/subagent/tool-subagent/README.zh.md index c72ed4e8d7..7c10ef6848 100644 --- a/packages/subagent/tool-subagent/README.zh.md +++ b/packages/subagent/tool-subagent/README.zh.md @@ -153,7 +153,7 @@ kind: "package-reference" #### 模型看到什么 -可选的 `list_subagent_models` 定义读取调用 Session 的路由策略，没有已记录策略时使用当前父级路由。可选的 `ctx.llm` 服务不可用时，调用会被拒绝。有已记录策略时，提供方模型列表取公布目录与 Session 授权路由的交集。没有策略时，只解析当前父级模型，即使目录未列出它。发现工具自身的描述要求模型在选择子级路由前查询选项；未挂载或过滤掉发现工具时，这段指导也不会出现。精确模型查询允许已授权但目录未列出的 ID；未授权的提供方／模型查询会在访问适配器前失败。目录或精确模型查询失败以及取消都会使调用被拒绝。执行过程独立强制同一策略。 +可选的 `list_subagent_models` 定义读取调用 Session 的路由策略，没有已记录策略时使用当前父级路由。可选的 `ctx.llm` 服务不可用时，调用会被拒绝。有已记录策略时，提供方模型列表取公布目录与 Session 授权路由的交集。没有策略时，只解析当前父级模型，即使目录未列出它。发现工具自身的描述要求模型只在覆盖子级路由时查询，说明不带路由字段的委派会继承父级路由，且字段应省略而不是传空；未挂载或过滤掉发现工具时，这段指导也不会出现。精确模型查询允许已授权但目录未列出的 ID；未授权的提供方／模型查询会在访问适配器前失败。目录或精确模型查询失败以及取消都会使调用被拒绝。执行过程独立强制同一策略。 #### Token 影响 diff --git a/packages/subagent/tool-subagent/src/index.ts b/packages/subagent/tool-subagent/src/index.ts index cbed72642b..86fb2b34fa 100644 --- a/packages/subagent/tool-subagent/src/index.ts +++ b/packages/subagent/tool-subagent/src/index.ts @@ -242,15 +242,15 @@ export async function apply(ctx: Context, config: Config): Promise { ...modelSelectionEnabled ? { provider: { type: 'string' as const, - description: 'Child LLM provider id.', + description: 'Child LLM provider id; omit together with `model` to inherit the parent route.', }, model: { type: 'string' as const, - description: 'Model id within that provider.', + description: 'Model id within that provider; omit together with `provider` to inherit the parent route.', }, reasoning_effort: { type: 'string' as const, - description: 'Model-specific reasoning effort id.', + description: 'Model-specific reasoning effort id; omit to use the model\'s default.', }, } : {}, }, diff --git a/packages/subagent/tool-subagent/src/list-models.ts b/packages/subagent/tool-subagent/src/list-models.ts index a0ad4cc7ac..632ce0bb2f 100644 --- a/packages/subagent/tool-subagent/src/list-models.ts +++ b/packages/subagent/tool-subagent/src/list-models.ts @@ -109,9 +109,10 @@ export function registerListSubagentModels( ctx.tools.register(defineTool({ name: 'list_subagent_models', description: - 'Inspect subagent models without changing the current Agent. No arguments: providers; ' - + '`provider`: allowed models; `provider` + `model`: that model and its reasoning efforts. ' - + 'Inspect options here before selecting a child provider and model; use returned ids for delegation.', + 'Inspect the subagent routes this Session authorizes. No arguments: authorized providers. ' + + '`provider`: that provider\'s authorized models. `provider` + `model`: that model and its reasoning efforts. ' + + 'Query only to override the child route; delegation without `provider` and `model` inherits the parent route. ' + + 'Omit a field rather than sending an empty string.', parameters: { provider: { type: 'string', diff --git a/packages/subagent/tool-subagent/tests/model-selection.spec.ts b/packages/subagent/tool-subagent/tests/model-selection.spec.ts index 8a1858b0c5..907c29ad90 100644 --- a/packages/subagent/tool-subagent/tests/model-selection.spec.ts +++ b/packages/subagent/tool-subagent/tests/model-selection.spec.ts @@ -166,7 +166,7 @@ describe('dsh-tool-subagent model selection', () => { const ctx = await setup({ provider: 'mock', modelSelection: true }) const agent = modelSelectionSetupAgent(ctx) const descriptions = () => ctx.tools.schemas(agent).map(schema => schema.description).join('\n') - const guidance = 'Inspect options here before selecting a child provider and model' + const guidance = 'Query only to override the child route' expect(descriptions()).not.toContain(guidance) expect(descriptions()).not.toContain('list_subagent_models') diff --git a/snapshots/sdk/subagent-dsh-sdk-dynamic-route/tool-schemas.expected.json b/snapshots/sdk/subagent-dsh-sdk-dynamic-route/tool-schemas.expected.json index 41244b3a87..5ac4801e1e 100644 --- a/snapshots/sdk/subagent-dsh-sdk-dynamic-route/tool-schemas.expected.json +++ b/snapshots/sdk/subagent-dsh-sdk-dynamic-route/tool-schemas.expected.json @@ -265,7 +265,7 @@ }, { "name": "list_subagent_models", - "description": "Inspect subagent models without changing the current Agent. No arguments: providers; `provider`: allowed models; `provider` + `model`: that model and its reasoning efforts. Inspect options here before selecting a child provider and model; use returned ids for delegation.", + "description": "Inspect the subagent routes this Session authorizes. No arguments: authorized providers. `provider`: that provider's authorized models. `provider` + `model`: that model and its reasoning efforts. Query only to override the child route; delegation without `provider` and `model` inherits the parent route. Omit a field rather than sending an empty string.", "parameters": { "type": "object", "properties": { @@ -377,15 +377,15 @@ }, "provider": { "type": "string", - "description": "Child LLM provider id." + "description": "Child LLM provider id; omit together with `model` to inherit the parent route." }, "model": { "type": "string", - "description": "Model id within that provider." + "description": "Model id within that provider; omit together with `provider` to inherit the parent route." }, "reasoning_effort": { "type": "string", - "description": "Model-specific reasoning effort id." + "description": "Model-specific reasoning effort id; omit to use the model's default." } }, "required": [ diff --git a/snapshots/web/creation-recommendations/tool-schemas.expected.json b/snapshots/web/creation-recommendations/tool-schemas.expected.json index 9fd234d166..f9205dba3c 100644 --- a/snapshots/web/creation-recommendations/tool-schemas.expected.json +++ b/snapshots/web/creation-recommendations/tool-schemas.expected.json @@ -328,7 +328,7 @@ }, { "name": "list_subagent_models", - "description": "Inspect subagent models without changing the current Agent. No arguments: providers; `provider`: allowed models; `provider` + `model`: that model and its reasoning efforts. Inspect options here before selecting a child provider and model; use returned ids for delegation.", + "description": "Inspect the subagent routes this Session authorizes. No arguments: authorized providers. `provider`: that provider's authorized models. `provider` + `model`: that model and its reasoning efforts. Query only to override the child route; delegation without `provider` and `model` inherits the parent route. Omit a field rather than sending an empty string.", "parameters": { "type": "object", "properties": { @@ -661,15 +661,15 @@ }, "provider": { "type": "string", - "description": "Child LLM provider id." + "description": "Child LLM provider id; omit together with `model` to inherit the parent route." }, "model": { "type": "string", - "description": "Model id within that provider." + "description": "Model id within that provider; omit together with `provider` to inherit the parent route." }, "reasoning_effort": { "type": "string", - "description": "Model-specific reasoning effort id." + "description": "Model-specific reasoning effort id; omit to use the model's default." } }, "required": [ @@ -1290,7 +1290,7 @@ }, { "name": "list_subagent_models", - "description": "Inspect subagent models without changing the current Agent. No arguments: providers; `provider`: allowed models; `provider` + `model`: that model and its reasoning efforts. Inspect options here before selecting a child provider and model; use returned ids for delegation.", + "description": "Inspect the subagent routes this Session authorizes. No arguments: authorized providers. `provider`: that provider's authorized models. `provider` + `model`: that model and its reasoning efforts. Query only to override the child route; delegation without `provider` and `model` inherits the parent route. Omit a field rather than sending an empty string.", "parameters": { "type": "object", "properties": { @@ -1655,15 +1655,15 @@ }, "provider": { "type": "string", - "description": "Child LLM provider id." + "description": "Child LLM provider id; omit together with `model` to inherit the parent route." }, "model": { "type": "string", - "description": "Model id within that provider." + "description": "Model id within that provider; omit together with `provider` to inherit the parent route." }, "reasoning_effort": { "type": "string", - "description": "Model-specific reasoning effort id." + "description": "Model-specific reasoning effort id; omit to use the model's default." } }, "required": [ diff --git a/snapshots/web/fresh-round-trip/tool-schemas.expected.json b/snapshots/web/fresh-round-trip/tool-schemas.expected.json index 9654a10574..65ec55b166 100644 --- a/snapshots/web/fresh-round-trip/tool-schemas.expected.json +++ b/snapshots/web/fresh-round-trip/tool-schemas.expected.json @@ -328,7 +328,7 @@ }, { "name": "list_subagent_models", - "description": "Inspect subagent models without changing the current Agent. No arguments: providers; `provider`: allowed models; `provider` + `model`: that model and its reasoning efforts. Inspect options here before selecting a child provider and model; use returned ids for delegation.", + "description": "Inspect the subagent routes this Session authorizes. No arguments: authorized providers. `provider`: that provider's authorized models. `provider` + `model`: that model and its reasoning efforts. Query only to override the child route; delegation without `provider` and `model` inherits the parent route. Omit a field rather than sending an empty string.", "parameters": { "type": "object", "properties": { @@ -661,15 +661,15 @@ }, "provider": { "type": "string", - "description": "Child LLM provider id." + "description": "Child LLM provider id; omit together with `model` to inherit the parent route." }, "model": { "type": "string", - "description": "Model id within that provider." + "description": "Model id within that provider; omit together with `provider` to inherit the parent route." }, "reasoning_effort": { "type": "string", - "description": "Model-specific reasoning effort id." + "description": "Model-specific reasoning effort id; omit to use the model's default." } }, "required": [ diff --git a/snapshots/web/official-subagent-bundle/system-prompt.expected.md b/snapshots/web/official-subagent-bundle/system-prompt.expected.md index 2a61a71d23..b6683c2efc 100644 --- a/snapshots/web/official-subagent-bundle/system-prompt.expected.md +++ b/snapshots/web/official-subagent-bundle/system-prompt.expected.md @@ -154,7 +154,7 @@ interface ToolArgsMap { } & Record; /** List your entire subagent tree: the root agent and all reachable continuable descendants, including yourself. Rows carry ids, descriptions, and status; descendant rows carry parent ids and depth from the root. You can message any other agent in the subagent tree listed as running or inactive. running means it is working; inactive means no turn is executing; it does not indicate task completion, success, or failure. While you remain active, you will be notified when a direct child finishes; there is no need to keep checking its status. Use send_message to continue the conversation. */ list_agents: Record; - /** Inspect subagent models without changing the current Agent. No arguments: providers; `provider`: allowed models; `provider` + `model`: that model and its reasoning efforts. Inspect options here before selecting a child provider and model; use returned ids for delegation. */ + /** Inspect the subagent routes this Session authorizes. No arguments: authorized providers. `provider`: that provider's authorized models. `provider` + `model`: that model and its reasoning efforts. Query only to override the child route; delegation without `provider` and `model` inherits the parent route. Omit a field rather than sending an empty string. */ list_subagent_models: { /** Registered LLM provider id. */ provider?: string; @@ -249,11 +249,11 @@ interface ToolArgsMap { description: string; /** The complete, self-contained task for the subagent. It does not share this conversation's context, so include everything it needs. */ prompt: string; - /** Child LLM provider id. */ + /** Child LLM provider id; omit together with `model` to inherit the parent route. */ provider?: string; - /** Model id within that provider. */ + /** Model id within that provider; omit together with `provider` to inherit the parent route. */ model?: string; - /** Model-specific reasoning effort id. */ + /** Model-specific reasoning effort id; omit to use the model's default. */ reasoning_effort?: string; } & Record; /** Delegate a self-contained task to a subagent (a separate agent that works in its own context) to offload focused, independent work — research, a scoped implementation, an analysis — so it does not consume this conversation's context. The subagent returns its result, not its intermediate steps. This tool starts an independently managed subagent and immediately returns its id. If you are still online when it finishes, the runtime automatically delivers its completion notice. The notice includes the final answer unless the child sent you a message just before finishing. This backend does not accept follow-up messages. */ diff --git a/snapshots/web/optional-string-editor/system-prompt.expected.md b/snapshots/web/optional-string-editor/system-prompt.expected.md index faf281da87..29b6f62ba6 100644 --- a/snapshots/web/optional-string-editor/system-prompt.expected.md +++ b/snapshots/web/optional-string-editor/system-prompt.expected.md @@ -154,7 +154,7 @@ interface ToolArgsMap { } & Record; /** List your entire subagent tree: the root agent and all reachable continuable descendants, including yourself. Rows carry ids, descriptions, and status; descendant rows carry parent ids and depth from the root. You can message any other agent in the subagent tree listed as running or inactive. running means it is working; inactive means no turn is executing; it does not indicate task completion, success, or failure. While you remain active, you will be notified when a direct child finishes; there is no need to keep checking its status. Use send_message to continue the conversation. */ list_agents: Record; - /** Inspect subagent models without changing the current Agent. No arguments: providers; `provider`: allowed models; `provider` + `model`: that model and its reasoning efforts. Inspect options here before selecting a child provider and model; use returned ids for delegation. */ + /** Inspect the subagent routes this Session authorizes. No arguments: authorized providers. `provider`: that provider's authorized models. `provider` + `model`: that model and its reasoning efforts. Query only to override the child route; delegation without `provider` and `model` inherits the parent route. Omit a field rather than sending an empty string. */ list_subagent_models: { /** Registered LLM provider id. */ provider?: string; @@ -266,11 +266,11 @@ interface ToolArgsMap { description: string; /** The complete, self-contained task for the subagent. It does not share this conversation's context, so include everything it needs. */ prompt: string; - /** Child LLM provider id. */ + /** Child LLM provider id; omit together with `model` to inherit the parent route. */ provider?: string; - /** Model id within that provider. */ + /** Model id within that provider; omit together with `provider` to inherit the parent route. */ model?: string; - /** Model-specific reasoning effort id. */ + /** Model-specific reasoning effort id; omit to use the model's default. */ reasoning_effort?: string; } & Record; /** Delegate a task to a subagent that inherits this conversation: a child agent seeded with all completed turns so far (it does not see the current in-flight turn). Use this when the subtask builds on this conversation's context — a follow-up analysis, a review, a continuation — without consuming this conversation's context for the work itself. You receive its result, not its intermediate steps. This tool starts an independently managed subagent and immediately returns its id. If you are still online when it finishes, the runtime automatically delivers its completion notice. The notice includes the final answer unless the child sent you a message just before finishing. Use `send_message` to steer it while running or continue its conversation after it finishes. */ diff --git a/snapshots/web/plugin-recommendations/tool-schemas.expected.json b/snapshots/web/plugin-recommendations/tool-schemas.expected.json index 9fd234d166..f9205dba3c 100644 --- a/snapshots/web/plugin-recommendations/tool-schemas.expected.json +++ b/snapshots/web/plugin-recommendations/tool-schemas.expected.json @@ -328,7 +328,7 @@ }, { "name": "list_subagent_models", - "description": "Inspect subagent models without changing the current Agent. No arguments: providers; `provider`: allowed models; `provider` + `model`: that model and its reasoning efforts. Inspect options here before selecting a child provider and model; use returned ids for delegation.", + "description": "Inspect the subagent routes this Session authorizes. No arguments: authorized providers. `provider`: that provider's authorized models. `provider` + `model`: that model and its reasoning efforts. Query only to override the child route; delegation without `provider` and `model` inherits the parent route. Omit a field rather than sending an empty string.", "parameters": { "type": "object", "properties": { @@ -661,15 +661,15 @@ }, "provider": { "type": "string", - "description": "Child LLM provider id." + "description": "Child LLM provider id; omit together with `model` to inherit the parent route." }, "model": { "type": "string", - "description": "Model id within that provider." + "description": "Model id within that provider; omit together with `provider` to inherit the parent route." }, "reasoning_effort": { "type": "string", - "description": "Model-specific reasoning effort id." + "description": "Model-specific reasoning effort id; omit to use the model's default." } }, "required": [ @@ -1290,7 +1290,7 @@ }, { "name": "list_subagent_models", - "description": "Inspect subagent models without changing the current Agent. No arguments: providers; `provider`: allowed models; `provider` + `model`: that model and its reasoning efforts. Inspect options here before selecting a child provider and model; use returned ids for delegation.", + "description": "Inspect the subagent routes this Session authorizes. No arguments: authorized providers. `provider`: that provider's authorized models. `provider` + `model`: that model and its reasoning efforts. Query only to override the child route; delegation without `provider` and `model` inherits the parent route. Omit a field rather than sending an empty string.", "parameters": { "type": "object", "properties": { @@ -1655,15 +1655,15 @@ }, "provider": { "type": "string", - "description": "Child LLM provider id." + "description": "Child LLM provider id; omit together with `model` to inherit the parent route." }, "model": { "type": "string", - "description": "Model id within that provider." + "description": "Model id within that provider; omit together with `provider` to inherit the parent route." }, "reasoning_effort": { "type": "string", - "description": "Model-specific reasoning effort id." + "description": "Model-specific reasoning effort id; omit to use the model's default." } }, "required": [ diff --git a/snapshots/web/ptc-round/system-prompt.expected.md b/snapshots/web/ptc-round/system-prompt.expected.md index 24c1e31f27..ab6b58d61c 100644 --- a/snapshots/web/ptc-round/system-prompt.expected.md +++ b/snapshots/web/ptc-round/system-prompt.expected.md @@ -154,7 +154,7 @@ interface ToolArgsMap { } & Record; /** List your entire subagent tree: the root agent and all reachable continuable descendants, including yourself. Rows carry ids, descriptions, and status; descendant rows carry parent ids and depth from the root. You can message any other agent in the subagent tree listed as running or inactive. running means it is working; inactive means no turn is executing; it does not indicate task completion, success, or failure. While you remain active, you will be notified when a direct child finishes; there is no need to keep checking its status. Use send_message to continue the conversation. */ list_agents: Record; - /** Inspect subagent models without changing the current Agent. No arguments: providers; `provider`: allowed models; `provider` + `model`: that model and its reasoning efforts. Inspect options here before selecting a child provider and model; use returned ids for delegation. */ + /** Inspect the subagent routes this Session authorizes. No arguments: authorized providers. `provider`: that provider's authorized models. `provider` + `model`: that model and its reasoning efforts. Query only to override the child route; delegation without `provider` and `model` inherits the parent route. Omit a field rather than sending an empty string. */ list_subagent_models: { /** Registered LLM provider id. */ provider?: string; @@ -249,11 +249,11 @@ interface ToolArgsMap { description: string; /** The complete, self-contained task for the subagent. It does not share this conversation's context, so include everything it needs. */ prompt: string; - /** Child LLM provider id. */ + /** Child LLM provider id; omit together with `model` to inherit the parent route. */ provider?: string; - /** Model id within that provider. */ + /** Model id within that provider; omit together with `provider` to inherit the parent route. */ model?: string; - /** Model-specific reasoning effort id. */ + /** Model-specific reasoning effort id; omit to use the model's default. */ reasoning_effort?: string; } & Record; /** Delegate a task to a subagent that inherits this conversation: a child agent seeded with all completed turns so far (it does not see the current in-flight turn). Use this when the subtask builds on this conversation's context — a follow-up analysis, a review, a continuation — without consuming this conversation's context for the work itself. You receive its result, not its intermediate steps. This tool starts an independently managed subagent and immediately returns its id. If you are still online when it finishes, the runtime automatically delivers its completion notice. The notice includes the final answer unless the child sent you a message just before finishing. Use `send_message` to steer it while running or continue its conversation after it finishes. */