0d00106fa8
A subagent child's recursion depth lived only in runtime AgentOptions, so a persisted child came back from resume counted as top-level and maxDepth stopped binding after every restart. Add SessionHeader.delegationDepth, round-trip it through the JSONL and SQLite backends (SQLite schema v5), restore it on agent-loop resume, and write it when the in-process backends create a child. The seam now owns the shared depth vocabulary (delegationDepthOf): the persisted header is authoritative and monotone — runtime options may deepen it but never lower it.
90 lines
3.1 KiB
Markdown
90 lines
3.1 KiB
Markdown
<!-- Generated by scripts/gen-website-api.ts — do not edit by hand. Run `pnpm run gen-website-api` to regenerate. -->
|
|
|
|
# ctx.subagents
|
|
|
|
`SubagentService` — provided by `@deepseek-ai/dsh-subagent`.
|
|
|
|
Named provider registry and capability-checked start surface.
|
|
|
|
[Source](https://github.com/deepseek-harness/deepseek-harness/blob/master/packages/subagent/subagent/src/index.ts#L179)
|
|
|
|
### ctx.subagents.registerProvider(provider)
|
|
|
|
```ts website-api
|
|
/**
|
|
* Register a provider under its name. Registration is effect-scoped and HMR
|
|
* safe; removing a provider blocks new starts but does not revoke runs that
|
|
* were already returned to their holders.
|
|
* @param provider - the trusted provider implementation.
|
|
* @returns the exact Cordis effect disposer.
|
|
*/
|
|
registerProvider(provider: SubagentProvider): () => void
|
|
```
|
|
|
|
Register a provider under its name. Registration is effect-scoped and HMR safe; removing a provider blocks new starts but does not revoke runs that were already returned to their holders.
|
|
|
|
- `provider` — the trusted provider implementation.
|
|
|
|
**Returns** the exact Cordis effect disposer.
|
|
|
|
[Source](https://github.com/deepseek-harness/deepseek-harness/blob/master/packages/subagent/subagent/src/index.ts#L193)
|
|
|
|
### ctx.subagents.getProvider(name)
|
|
|
|
```ts website-api
|
|
/**
|
|
* Look up a provider by name.
|
|
* @param name - the provider name.
|
|
* @returns the provider, or undefined when absent.
|
|
*/
|
|
getProvider(name: string): SubagentProvider | undefined
|
|
```
|
|
|
|
Look up a provider by name.
|
|
|
|
- `name` — the provider name.
|
|
|
|
**Returns** the provider, or undefined when absent.
|
|
|
|
[Source](https://github.com/deepseek-harness/deepseek-harness/blob/master/packages/subagent/subagent/src/index.ts#L216)
|
|
|
|
### ctx.subagents.list()
|
|
|
|
```ts website-api
|
|
/**
|
|
* List registered provider names in insertion order.
|
|
* @returns the registered names.
|
|
*/
|
|
list(): string[]
|
|
```
|
|
|
|
List registered provider names in insertion order.
|
|
|
|
**Returns** the registered names.
|
|
|
|
[Source](https://github.com/deepseek-harness/deepseek-harness/blob/master/packages/subagent/subagent/src/index.ts#L224)
|
|
|
|
### ctx.subagents.start(name, request)
|
|
|
|
```ts website-api
|
|
/**
|
|
* Establish a ready child on the named provider. Capability and semantic
|
|
* checks run before delegation. Provider ownership lasts until its promise
|
|
* fulfills; a rejection therefore has no run for the caller to dispose and
|
|
* emits no run lifecycle events.
|
|
* @param name - the provider to use.
|
|
* @param request - child prompt, parent, signal, and optional capabilities.
|
|
* @returns the ready holder-owned run.
|
|
*/
|
|
async start(name: string, request: SubagentStartRequest): Promise<SubagentRun>
|
|
```
|
|
|
|
Establish a ready child on the named provider. Capability and semantic checks run before delegation. Provider ownership lasts until its promise fulfills; a rejection therefore has no run for the caller to dispose and emits no run lifecycle events.
|
|
|
|
- `name` — the provider to use.
|
|
- `request` — child prompt, parent, signal, and optional capabilities.
|
|
|
|
**Returns** the ready holder-owned run.
|
|
|
|
[Source](https://github.com/deepseek-harness/deepseek-harness/blob/master/packages/subagent/subagent/src/index.ts#L237)
|