@deepseek-ai/dsh-tool-cordis 0.2.1-alpha.1 → 0.2.1-alpha.2

package/lib/types/api-catalog.js

@@ -274,9 +274,9 @@ export const SERVICE_API = [
             },
             {
                 signature: 'async sendMessage(caller: Agent, request: SendTeamMessageRequest): Promise<SendTeamMessageResult>',
-                description: 'Queue one durable peer message, then attempt immediate delivery.',
-                parameters: [{ name: 'caller', description: 'exact live sending Team member.' }, { name: 'request', description: 'target name, content, and pre-queue cancellation.' }],
-                returns: 'durable message identity and immediate-delivery observation.',
+                description: 'Steer one peer message into the target inbox or reject the attempt.',
+                parameters: [{ name: 'caller', description: 'exact live sending Team member.' }, { name: 'request', description: 'target name, content, and cancellation before acceptance.' }],
+                returns: 'accepted inbox identity; acceptance follows normal Agent persistence and does not await model processing.',
             },
             {
                 signature: 'async createTask(caller: Agent, request: CreateTeamTaskRequest): Promise<TeamTaskView>',
@@ -690,6 +690,11 @@ export const SERVICE_API = [
                 description: 'The operator Peer every admitted request speaks for; its scope lives as long as Connection.',
                 parameters: [],
             },
+            {
+                signature: 'readonly allowsRemoteAuthorities: boolean',
+                description: 'Whether this deployment accepts authorities beyond loopback: true only when a validated `trustedHosts` entry names a non-loopback hostname.',
+                parameters: [],
+            },
             {
                 signature: 'createSharedFetchHandler(channel: \'/api\'): ConnectionFetchHandler',
                 description: 'Compose exact Fetch routes and the shared-channel RPC interceptor.',
@@ -710,7 +715,7 @@ export const SERVICE_API = [
             },
             {
                 signature: 'authorizeIndex(request: ConnectionIndexRequest, response: ConnectionIndexResponse): boolean',
-                description: 'Authenticate one frontend index request, owning a token redirect or 401.',
+                description: 'Authenticate one frontend index request, owning a token redirect or 401. The cookie this mints is `Secure` when the mounted Web carrier serves TLS, which only that listener\'s protocol decides.',
                 parameters: [{ name: 'request', description: 'root or configured-index HTTP request.' }, { name: 'response', description: 'response owned when the result is false.' }],
                 returns: 'true only when the frontend may serve index.html.',
             },
@@ -722,6 +727,25 @@ export const SERVICE_API = [
             },
         ],
     },
+    {
+        key: 'cotTranslation',
+        summary: 'Optional reasoning translation delegates Session-bound storage to the translator.',
+        description: 'Optional reasoning translation delegates Session-bound storage to the translator.',
+        methods: [
+            {
+                signature: '@Remote async limits(signal: AbortSignal): Promise<CotTranslationSnapshot>',
+                description: 'Read accepted translation preferences and the current request limit without sending text.',
+                parameters: [{ name: 'signal', description: 'browser query cancellation or Remote contribution withdrawal.' }],
+                returns: 'authoritative preferences, eligible routes, and maximum UTF-16 text length per request.',
+            },
+            {
+                signature: '@Remote async translate(request: TranslationRequest, signal: AbortSignal): Promise<string>',
+                description: 'Translate one displayed fragment through the reader\'s selected provider.',
+                parameters: [{ name: 'request', description: 'original text and Session identity supplied by the Client; provider and explicit target language match accepted preferences, while auto uses the browser locale.' }, { name: 'signal', description: 'browser cancellation or Remote contribution withdrawal.' }],
+                returns: 'translated text; an uncached inactive Session joins ordinary GUI activation before retry. Failures omit the source and provider response. Cancellation stops this caller\'s wait, not shared activation.',
+            },
+        ],
+    },
     {
         key: 'credentials',
         summary: 'Abstract credential service over two key spaces that answer two questions.',
@@ -904,7 +928,7 @@ export const SERVICE_API = [
             },
             {
                 signature: 'async prepare(request: DeepSeekLlmApiExtensionRequest): Promise<PreparedDeepSeekLlmApiExtensions>',
-                description: 'Prepare every currently registered field from one immutable base request. Preparation failures reject before HTTP dispatch. Field values are cloned and frozen; providers retain no mutable alias to the outgoing request.',
+                description: 'Prepare every currently registered field from one immutable base request. A provider whose preparation throws, or whose value cannot be cloned, is omitted from this request; the first such failure per field is logged. Only cancellation rejects. Field values are cloned and frozen; providers retain no mutable alias to the outgoing request.',
                 parameters: [{ name: 'request', description: 'exact serialized request facts before extension fields.' }],
                 returns: 'detached fields and their idempotent joint acceptance transaction.',
             },
@@ -1397,9 +1421,9 @@ export const SERVICE_API = [
                 returns: 'a detached config only when a default must be materialized.',
             },
             {
-                signature: 'async prepareCall(config: LlmCallConfig, signal?: AbortSignal): Promise<PreparedLlmCall>',
-                description: 'Resolve one call under its current adapter registration. The returned one-shot handle keeps that registration across header logging and dispatch, so HMR cannot combine one adapter\'s capability result with another adapter.',
-                parameters: [{ name: 'config', description: 'provider/model route and optional request controls.' }, { name: 'signal', description: 'optional cancellation for adapter-owned capability lookup.' }],
+                signature: 'async prepareCall( config: LlmCallConfig, signal?: AbortSignal, configure?: ConfigureCall, ): Promise<PreparedLlmCall>',
+                description: 'Resolve one call under its current adapter registration. The returned one-shot handle keeps that registration across header logging and dispatch, so HMR cannot combine one adapter\'s capability result with another adapter. An optional synchronous callback selects concrete controls using captured model metadata. Defaults and validation apply to its result. Callback failures and cancellation reject preparation before dispatch.',
+                parameters: [{ name: 'config', description: 'provider/model route and optional concrete request controls.' }, { name: 'signal', description: 'optional cancellation for adapter-owned capability lookup.' }, { name: 'configure', description: 'pure control selection, called once before defaults and validation.' }],
                 returns: 'a prepared config and its registration-bound stream entry point.',
             },
             {
@@ -1605,7 +1629,7 @@ export const SERVICE_API = [
             },
             {
                 signature: '@Remote listBundles(): Promise<BundleInfo[]>',
-                description: 'Read the profile\'s installed bundles, the bundles this dsh installation supplies, and the selected names that are not bundles. A dependency without a bundle patch is listed, as a `not-bundle` problem, only while it is selected.',
+                description: 'Read installed, installation-provided, and offline Official catalog bundles, plus selected non-bundle names. A dependency without a bundle patch is listed, as a `not-bundle` problem, only while it is selected.',
                 parameters: [],
                 returns: 'Package versions, manifest descriptions, the installable spec of profile dependencies, rows, optional display metadata, activation selections, whether the installation offers the bundle, and removal availability.',
             },
@@ -1636,7 +1660,7 @@ export const SERVICE_API = [
             {
                 signature: '@Remote installBundle(spec: string, options?: InstallBundleOptions): Promise<ChangeResult>',
                 description: 'Install a package using the same pnpm implementation as dsh plugin. GitHub repositories get a connection check bounded by githubConnectionTimeoutMs before pnpm starts; only network failures or timeouts stop installation, while pnpm owns authentication and transport fallback. A run that fails, is cancelled, or adds a package without a bundle patch restores `package.json` and `pnpm-lock.yaml` as they were; downloaded files can stay.',
-                parameters: [{ name: 'spec', description: 'One package spec, including local paths relative to the invocation directory.' }, { name: 'options', description: 'Whether to activate the installed bundle (defaults to true), the request id a cancellation names, the pending build scripts to allow for this profile before pnpm runs, and the registry asked first.' }],
+                parameters: [{ name: 'spec', description: 'One package spec, including local paths relative to the invocation directory.' }, { name: 'options', description: 'Whether to activate the installed bundle (defaults to true), the request id a cancellation names, the pending build scripts to allow, whether to save an exact dependency, and the registry asked first.' }],
                 returns: 'Package-manager diagnostics, the registries asked, and the observed activation outcome.',
             },
             {
@@ -1939,9 +1963,9 @@ export const SERVICE_API = [
                 returns: 'the accepted title and durable event sequence.',
             },
             {
-                signature: '@Remote(\'fork\') fork(request: SessionForkRequest): Promise<SessionForkValue>',
+                signature: '@Remote(\'fork\') async fork(request: SessionForkRequest): Promise<SessionForkValue>',
                 description: 'Fork one cold-readable exact event prefix into a new Session. An omitted boundary selects the latest completed-turn prefix; an open cut receives synthetic fork closers.',
-                parameters: [{ name: 'request', description: 'source Session and optional exact inclusive event boundary.' }],
+                parameters: [{ name: 'request', description: 'source Session, optional exact inclusive event boundary, and migration preflight choice.' }],
                 returns: 'the new Session identity.',
             },
             {
@@ -1982,9 +2006,9 @@ export const SERVICE_API = [
             },
             {
                 signature: '@Remote(\'projections\') async projections(request: SessionProjectionsRequest, signal: AbortSignal): Promise<SessionProjectionsValue>',
-                description: 'Read all registered projections without activating an Agent.',
-                parameters: [{ name: 'request', description: 'Session whose current values are required.' }, { name: 'signal', description: 'cancellation for the Session observation.' }],
-                returns: 'complete baseline, or null when the Session does not exist.',
+                description: 'Read exact projections, returning cached hints only when migration is required.',
+                parameters: [{ name: 'request', description: 'Session whose current values are required.' }, { name: 'signal', description: 'cancellation for the Session read.' }],
+                returns: 'a sequenced baseline, cached hints when migration is deferred, or null when absent.',
             },
             {
                 signature: '@Remote({ mode: \'stream\' }) control(signal: AbortSignal): AsyncIterable<SessionControlFrame>',
@@ -2435,7 +2459,7 @@ export const SERVICE_API = [
             },
             {
                 signature: 'register(provider: SessionTitleProvider): () => Promise<void>',
-                description: 'Register the sole optional title provider. Disposal aborts its pending and active work before another provider may register.',
+                description: 'Register the sole optional title provider. Disposal aborts its pending and active work; a replacement may register once disposal has started, and the closing provider\'s late results never commit.',
                 parameters: [{ name: 'provider', description: 'provider identity, cadence, and generation function.' }],
                 returns: 'exact Cordis effect disposer, which settles after active calls quiesce.',
             },
@@ -2814,8 +2838,8 @@ export const SERVICE_API = [
     },
     {
         key: 'subagents',
-        summary: 'Named provider registry with one-shot runs, durable discovery, and continuable-child operations.',
-        description: 'Named provider registry with one-shot runs, durable discovery, and continuable-child operations.',
+        summary: 'Named provider registry with managed activations, durable discovery, and local child messaging.',
+        description: 'Named provider registry with managed activations, durable discovery, and local child messaging.',
         methods: [
             {
                 signature: 'resolveMaxDepth(configured?: number | \'provider-managed\'): number | undefined',
@@ -2824,11 +2848,22 @@ export const SERVICE_API = [
                 returns: 'The numeric limit, or undefined when the provider owns depth enforcement.',
             },
             {
-                signature: 'async startContinuable(spec: ContinuableStartSpec): Promise<ContinuableStart>',
-                description: 'Establish one durable continuable child and deliver its initial prompt. Resolves when the child\'s inbox accepts that prompt, without waiting for the turn to start or for the message to reach the Session log; any earlier failure rejects with no ids and rolls back the child entirely.',
-                parameters: [{ name: 'spec', description: 'provider, delegation request, and caller cancellation.' }],
-                returns: 'the durable child id and the accepted prompt\'s message id.',
-                throws: ['when continuation services are unavailable or materialization fails.'],
+                signature: 'startActivation(spec: SubagentActivationSpec & { readonly childId: SessionId }): Promise<SubagentActivation & { readonly messageId: MessageId }>',
+                description: 'Start a local child under its reserved identity.',
+                parameters: [{ name: 'spec', description: 'local task, reserved child id, and result recipient.' }],
+                returns: 'activation with its accepted initial message id.',
+            },
+            {
+                signature: 'startActivation(spec: SubagentActivationSpec): Promise<SubagentActivation>',
+                description: 'Start a local or external child.',
+                parameters: [{ name: 'spec', description: 'task, backend, and result recipient.' }],
+                returns: 'activation with a message id only for local children.',
+            },
+            {
+                signature: 'async waitForChildren(parent: Agent): Promise<boolean>',
+                description: 'Join progressing descendants without cancelling them. Idle descendants whose inboxes require a later wake stay resident and do not delay host completion.',
+                parameters: [{ name: 'parent', description: 'the exact parent whose descendant work is observed.' }],
+                returns: 'whether work was joined; hosts recheck parent idle after true.',
             },
             {
                 signature: 'async sendMessage( sender: Agent, targetId: SessionId, content: ContentBlock[], options: SubagentSendMessageOptions, ): Promise<MessageId>',
@@ -2839,22 +2874,22 @@ export const SERVICE_API = [
             },
             {
                 signature: 'interrupt(targetSessionId: SessionId, authority: SubagentInterruptAuthority): void',
-                description: 'Interrupt one live continuable child\'s current turn under a human parent address or an exact live ancestor Agent. Fire-and-return: the cancel signal is issued before this returns, but the target may keep running until it observes the signal. Unclaimed pending inbox work, the Activation, and published descendants are preserved; claimed work is not requeued. Once the interrupted driver is idle, a waking send resumes the parked FIFO queue. An absent target — including a one-shot or unknown id — is an accepted no-op, as is a manager-less composition, which cannot own a live Activation.',
+                description: 'Interrupt one live child\'s current execution under a human parent address or an exact live ancestor Agent. Fire-and-return: the cancel signal is issued before this returns, but the target may keep running until it observes the signal. Unclaimed pending inbox work, the Activation, and published descendants are preserved; claimed work is not requeued. Once the interrupted Agent is idle, a waking send resumes the parked FIFO queue. External backends stop their single execution. An absent target is an accepted no-op, as is a manager-less composition, which cannot own a live Activation.',
                 parameters: [{ name: 'targetSessionId', description: 'the durable child session id to interrupt.' }, { name: 'authority', description: 'the human parent address or exact live ancestor Agent.' }],
                 throws: ['{SubagentError} `UNAUTHORIZED` when the authority does not own the live target.'],
             },
             {
-                signature: 'async drainContinuableDescendants(parents: readonly Agent[]): Promise<void>',
-                description: 'Close continuable admission below exact live parent Agents, stop only their visible descendant Activations synchronously, then await admitted scoped materializations and release those forests child-first. The scoped cutoff lasts until each exact parent leaves the registry; unrelated parent trees remain live.',
+                signature: 'async drainDescendants(parents: readonly Agent[]): Promise<void>',
+                description: 'Close subagent admission below exact live parent Agents, stop only their visible descendant Activations synchronously, then await admitted scoped materializations and release those forests child-first. The scoped cutoff lasts until each exact parent leaves the registry; unrelated parent trees remain live.',
                 parameters: [{ name: 'parents', description: 'exact host-owned parent Agents entering teardown.' }],
-                returns: 'once every retained descendant Activation released its `AgentHandle`.',
+                returns: 'once every retained descendant activation released its execution handle.',
                 throws: ['an aggregate error after all branches settle when any failed.'],
             },
             {
-                signature: 'async drainContinuableChildren(parent: Agent, childIds: readonly SessionId[]): Promise<void>',
-                description: 'Release selected resident continuable direct children of one exact live parent. Other children of the same parent remain admitted and resident. Absent targets and a manager-less composition are accepted no-ops.',
+                signature: 'async drainChildren(parent: Agent, childIds: readonly SessionId[]): Promise<void>',
+                description: 'Release selected resident direct children of one exact live parent. Other children of the same parent remain admitted and resident. Absent targets and a manager-less composition are accepted no-ops.',
                 parameters: [{ name: 'parent', description: 'exact live direct parent authorizing the selected release.' }, { name: 'childIds', description: 'durable direct-child ids to release when resident.' }],
-                returns: 'once every selected Activation released its `AgentHandle`.',
+                returns: 'once every selected activation released its execution handle.',
                 throws: ['{SubagentError} `UNAUTHORIZED` when a resident target belongs to a different parent or the supplied parent identity is stale.'],
             },
             {
@@ -2866,7 +2901,7 @@ export const SERVICE_API = [
             },
             {
                 signature: 'listDescendants(rootSessionId: SessionId, signal?: AbortSignal): Promise<SubagentDescendantListEntry[]>',
-                description: 'Recursively list reachable parent catalogs in stable pre-order, preserving each catalog\'s event order. Each row carries its catalog parent and depth; one-shot and unknown-mode children remain traversal nodes. Unknown modes produce unsupported diagnostics. Unreadable child catalogs produce corrupt or unavailable diagnostics and stop only that branch. Root read failures, missing services or projections, and cancellation reject the whole listing. Each catalog is observed once and released before the next read. No Agent is loaded or resumed; Sessions absent from reachable catalogs are omitted.',
+                description: 'Recursively list reachable parent catalogs in stable pre-order, preserving each catalog\'s event order. Each row carries its catalog parent and depth; external children are leaves; one-shot and unknown-mode children remain traversal nodes. Unknown modes produce unsupported diagnostics. Unreadable child catalogs produce corrupt or unavailable diagnostics and stop only that branch. Root read failures, missing services or projections, and cancellation reject the whole listing. Each catalog is observed once and released before the next read. No Agent is loaded or resumed; Sessions absent from reachable catalogs are omitted.',
                 parameters: [{ name: 'rootSessionId', description: 'session whose catalog starts descendant discovery.' }, { name: 'signal', description: 'cancellation forwarded to and checked around each catalog read.' }],
                 returns: 'children and branch diagnostics in parent-catalog pre-order.',
                 throws: ['{@link SubagentError} when listing dependencies are unavailable or the caller cancels.', 'SessionQueryError when the root catalog cannot be read.'],
@@ -2887,7 +2922,7 @@ export const SERVICE_API = [
             },
             {
                 signature: 'registerProvider(provider: SubagentProvider): () => void',
-                description: '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.',
+                description: '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. Providers without either execution method are rejected with UNSUPPORTED_CAPABILITY before registration.',
                 parameters: [{ name: 'provider', description: 'the trusted provider implementation.' }],
                 returns: 'the exact Cordis effect disposer.',
             },
@@ -2903,12 +2938,6 @@ export const SERVICE_API = [
                 parameters: [],
                 returns: 'the registered names.',
             },
-            {
-                signature: 'async start(name: string, request: SubagentStartRequest): Promise<SubagentRun>',
-                description: 'Establish a published 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. Post-publication turn and infrastructure failures settle through the returned run. A catalog append failure disposes the run and handles its result rejection; the caller receives the catalog error even if disposal also fails.',
-                parameters: [{ name: 'name', description: 'the provider to use.' }, { name: 'request', description: 'child label, prompt, parent, signal, and optional capabilities.' }],
-                returns: 'the published holder-owned run.',
-            },
         ],
     },
     {
@@ -2974,7 +3003,7 @@ export const SERVICE_API = [
             },
             {
                 signature: 'suppressRuntimeContext(): () => void',
-                description: 'Suppress every dynamic runtime-context contribution in the calling context\'s scope without changing the services that own or enforce those facts. Multiple suppressors remain independently disposable.',
+                description: 'Suppress optional dynamic runtime-context contributions in the calling context\'s scope without changing the services that own or enforce those facts. Multiple suppressors remain independently disposable.',
                 parameters: [],
                 returns: 'the exact Cordis effect disposer.',
             },
@@ -2990,6 +3019,12 @@ export const SERVICE_API = [
                 parameters: [{ name: 'name', description: 'the `[a-z][a-z0-9_]*` reference name.' }, { name: 'provider', description: 'evaluated for each assembly.' }],
                 returns: 'the exact Cordis effect disposer.',
             },
+            {
+                signature: 'refreshContext(assembly: PromptAssembly, context: AssembleContext = {}): PromptAssembly',
+                description: 'Refresh accepted registered runtime facts for request admission. Contexts added only by the assembly waterfall retain their accepted values. Current suppression removes optional contexts, and missing required registrations are restored in registry order. Sections, tools, and interpolation variables retain the accepted assembly; their providers and waterfall do not rerun.',
+                parameters: [{ name: 'assembly', description: 'accepted assembly for this scope and step.' }, { name: 'context', description: 'the same scope and current plugin-defined assembly fields.' }],
+                returns: 'the accepted assembly with current runtime-context provider text.',
+            },
             {
                 signature: 'async assemble(context: AssembleContext = {}): Promise<PromptAssembly>',
                 description: 'Assemble global and scoped providers, detach tool parameters, apply canonical ordering, then run the assembly waterfall. Scoped sections and variables shadow globals. The returned waterfall value is authoritative except that an effective complete section is restored afterwards as the sole prompt section.',
@@ -3005,9 +3040,9 @@ export const SERVICE_API = [
         methods: [
             {
                 signature: '@Remote environment(agent: Agent, signal: AbortSignal): TerminalEnvironment',
-                description: 'Read the Session working directory and terminal limits without resolving a shell.',
+                description: 'Read the Session\'s current directory and terminal limits without filesystem validation or shell lookup.',
                 parameters: [{ name: 'agent', description: 'Session owner supplied by the Gateway.' }, { name: 'signal', description: 'request cancellation.' }],
-                returns: 'the Session workspace directory and terminal limits.',
+                returns: 'the logged current directory and terminal limits; retained terminals keep their own process directories.',
             },
             {
                 signature: '@Remote shells(agent: Agent, signal: AbortSignal): Promise<TerminalShell[]>',
@@ -3267,6 +3302,31 @@ export const SERVICE_API = [
             },
         ],
     },
+    {
+        key: 'translator',
+        summary: 'One Host service with explicit routing, cancellation and quiescent unload.',
+        description: 'One Host service with explicit routing, cancellation and quiescent unload.',
+        methods: [
+            {
+                signature: 'async availableProviders(signal?: AbortSignal): Promise<readonly TranslationProvider[]>',
+                description: 'Inspect eligible native routes without inference; saved results remain readable for unavailable routes.',
+                parameters: [{ name: 'signal', description: 'optional caller cancellation, combined with service disposal.' }],
+                returns: 'anonymous choices followed by eligible explicitly selected paid routes.',
+            },
+            {
+                signature: 'resolve(request: TranslationRequest): TranslationSpec',
+                description: 'Resolve provider and source-language defaults without sending text.',
+                parameters: [{ name: 'request', description: 'consumer text, destination and optional routing choices.' }],
+                returns: 'a complete specification; exceeding `maxTextChars` throws `TRANSLATION_TEXT_LIMIT`.',
+            },
+            {
+                signature: 'async translate(spec: TranslationSpec, signal?: AbortSignal): Promise<string>',
+                description: 'Translate one resolved specification; the selected provider receives its text.',
+                parameters: [{ name: 'spec', description: 'complete routing and language choices from `resolve()`.' }, { name: 'signal', description: 'optional caller cancellation, combined with service disposal.' }],
+                returns: 'translated plain text, durably retained before return when a Session is supplied. An uncached supplied Session must be active; otherwise rejects with `TRANSLATION_SESSION_INACTIVE` before dispatch. Rejects provider/storage/limit failures and preserves cancellation reasons.',
+            },
+        ],
+    },
     {
         key: 'typert',
         summary: 'Registry of generated schemas, package reflection, invocations, and Remote dependency providers.',
@@ -3441,7 +3501,7 @@ export const SERVICE_API = [
     {
         key: 'webServer',
         summary: 'The browser HTTP carrier service.',
-        description: 'The browser HTTP carrier service. Activation listens immediately. Route registration order does not affect requests because configured named routes must be distinct, and the fallback handler answers anything not yet claimed during startup with 404 until its owner registers. A listen failure rejects initialization, and the boot process reports the failed fiber.',
+        description: 'The browser HTTP carrier service. Activation loads any configured TLS material, then listens immediately; a material or listen failure rejects initialization, and the boot process reports the failed fiber. Route registration order does not affect requests because configured named routes must be distinct, and the fallback handler answers anything not yet claimed during startup with 404 until its owner registers.',
         methods: [
             {
                 signature: 'register(route: WebRoute): () => void',
@@ -3500,6 +3560,38 @@ export const SERVICE_API = [
             },
         ],
     },
+    {
+        key: 'workingDirectory',
+        summary: 'One owner for each Session\'s effective directory and its model-visible changes.',
+        description: 'One owner for each Session\'s effective directory and its model-visible changes.',
+        methods: [
+            {
+                signature: 'readonly defaultDirectory: string',
+                description: 'Absolute deployment fallback for Sessions with no recorded original directory.',
+                parameters: [],
+            },
+            {
+                signature: 'get(session: Session): string',
+                description: 'Read the committed directory without filesystem I/O.',
+                parameters: [{ name: 'session', description: 'Session whose directory is requested.' }],
+                returns: 'its effective absolute directory.',
+            },
+            {
+                signature: 'ensure(agent: Agent, signal?: AbortSignal): Promise<string>',
+                description: 'Validate the current directory and restore the original project when it disappeared.',
+                parameters: [{ name: 'agent', description: 'live or unpublished Agent owning the Session.' }, { name: 'signal', description: 'cancellation for filesystem inspection.' }],
+                returns: 'the existing directory; recovery is committed before fulfillment. A notice failure is warned without reverting the committed state.',
+                throws: ['when the original project is also unavailable.'],
+            },
+            {
+                signature: 'set(agent: Agent, path: string, signal?: AbortSignal): Promise<string>',
+                description: 'Change one Session\'s directory without changing existing processes or permissions.',
+                parameters: [{ name: 'agent', description: 'live or unpublished Agent owning the Session.' }, { name: 'path', description: 'absolute path or a path relative to its current directory.' }, { name: 'signal', description: 'cancellation before the durable change.' }],
+                returns: 'the canonical absolute directory, committed before fulfillment. A notice failure is warned; the next request still receives the committed directory.',
+                throws: ['when the requested path is not an existing directory.'],
+            },
+        ],
+    },
     {
         key: 'workspaceChanges',
         summary: 'Serves the summaries and file comparisons the recorder keeps for live Sessions.',
@@ -3704,6 +3796,19 @@ export const SERVICE_API = [
             },
         ],
     },
+    {
+        key: 'worktrees',
+        summary: 'Creates retained Git worktrees under the mounted filesystem and sandbox providers.',
+        description: 'Creates retained Git worktrees under the mounted filesystem and sandbox providers.',
+        methods: [
+            {
+                signature: 'async create(agent: Agent, request: CreateWorktreeRequest = {}, signal?: AbortSignal): Promise<CreatedWorktree>',
+                description: 'Create a fresh branch and checkout at a pinned local revision, then enter it. Existing branches or checkout paths fail. Uncommitted files stay in the source checkout. Checkout disables configured clean, smudge, and process filters without changing Git config. Repository-local replacement refs still apply; baseCommit reports the resolved object name. The new checkout becomes current only after Git setup succeeds. Failures may retain newly allocated Git/filesystem artifacts; no branch or checkout is removed automatically.',
+                parameters: [{ name: 'agent', description: 'caller whose current directory selects the source repository and file policy.' }, { name: 'request', description: 'optional new name and local revision; defaults are generated name and HEAD.' }, { name: 'signal', description: 'cancellation of lookup, creation, and working-directory publication.' }],
+                returns: 'canonical checkout path, branch name, pinned commit, and source repository root.',
+            },
+        ],
+    },
 ];
 /** Every harness event, sorted by name. */
 export const EVENT_API = [
@@ -4470,6 +4575,14 @@ export const TYPE_API = [
         name: 'AgentStatus',
         declaration: 'export type AgentStatus = \'idle\' | \'running\';',
     },
+    {
+        name: 'AnonymousTranslationProvider',
+        declaration: 'export type AnonymousTranslationProvider = \'google\' | \'bing\';',
+    },
+    {
+        name: 'AnonymousTranslationSpec',
+        declaration: 'export interface AnonymousTranslationSpec extends TranslationSpecFields {\n    readonly provider: AnonymousTranslationProvider;\n}',
+    },
     {
         name: 'AnyHook',
         declaration: 'export type AnyHook = ModHook<unknown, unknown>;',
@@ -4544,7 +4657,7 @@ export const TYPE_API = [
     },
     {
         name: 'AssembledContext',
-        declaration: 'export interface AssembledContext {\n    name: string;\n    text: string;\n}',
+        declaration: 'export interface AssembledContext {\n    name: string;\n    text: string;\n    interpolate?: boolean;\n}',
     },
     {
         name: 'AssembledSection',
@@ -4672,7 +4785,7 @@ export const TYPE_API = [
     },
     {
         name: 'BundleInfo',
-        declaration: 'export interface BundleInfo {\n    name: string;\n    version?: string;\n    meta?: PluginLocalizedMeta;\n    description?: string;\n    enabled: boolean;\n    installed: boolean;\n    source?: string;\n    optional: boolean;\n    removable: boolean;\n    readOnlyReason?: ReadOnlyReason;\n    error?: ManagementError;\n    rows: BundleRowInfo[];\n    overrides: string[];\n}',
+        declaration: 'export interface BundleInfo {\n    name: string;\n    official: boolean;\n    availability: \'installation\' | \'profile\' | \'missing\';\n    installTarget?: {\n        spec: string;\n        version: string;\n    };\n    version?: string;\n    meta?: PluginLocalizedMeta;\n    description?: string;\n    enabled: boolean;\n    installed: boolean;\n    source?: string;\n    optional: boolean;\n    removable: boolean;\n    readOnlyReason?: ReadOnlyReason;\n    error?: ManagementError;\n    rows: BundleRowInfo[];\n    overrides: string[];\n}',
     },
     {
         name: 'BundleRowInfo',
@@ -4774,6 +4887,10 @@ export const TYPE_API = [
         name: 'ComputerUseProviderName',
         declaration: 'export type ComputerUseProviderName = Branded<\'ComputerUseProviderName\'>;',
     },
+    {
+        name: 'ConfigureCall',
+        declaration: 'export type ConfigureCall = (controls: Readonly<LlmCallControls>, model: Readonly<LlmResolvedModelInfo>) => LlmCallControls;',
+    },
     {
         name: 'ConfinedArgv',
         declaration: 'export interface ConfinedArgv {\n    argv: string[];\n    enforcement: SandboxEnforcement;\n    denialSignatures: readonly string[];\n    runnerFailureRules: readonly RunnerFailureRule[];\n}',
@@ -4848,24 +4965,12 @@ export const TYPE_API = [
     },
     {
         name: 'ContinuableCreateRequest',
-        declaration: 'export interface ContinuableCreateRequest {\n    readonly sessionId: SessionId;\n    readonly parent: Agent;\n    readonly signal: AbortSignal;\n}',
+        declaration: 'export interface ContinuableCreateRequest {\n    readonly cwd: string;\n    readonly sessionId: SessionId;\n    readonly parent: Agent;\n    readonly signal: AbortSignal;\n}',
     },
     {
         name: 'ContinuableCreateSpec',
         declaration: 'export interface ContinuableCreateSpec {\n    readonly seed?: readonly SessionEvent[];\n}',
     },
-    {
-        name: 'ContinuableStart',
-        declaration: 'export interface ContinuableStart {\n    readonly childId: SessionId;\n    readonly messageId: MessageId;\n}',
-    },
-    {
-        name: 'ContinuableStartSpec',
-        declaration: 'export interface ContinuableStartSpec {\n    readonly provider: string;\n    readonly label: string;\n    readonly childId?: SessionId;\n    readonly request: Omit<SubagentStartRequest, \'label\' | \'signal\' | \'outputSchema\'>;\n    readonly signal: AbortSignal;\n}',
-    },
-    {
-        name: 'ContinuableSubagentDescriptorData',
-        declaration: 'export interface ContinuableSubagentDescriptorData extends SubagentDescriptorBase {\n    readonly mode: \'continuable\';\n    readonly label: string;\n    readonly agentProvider?: string;\n    readonly agentModel?: string;\n    readonly agentReasoningEffort?: ReasoningEffortId;\n    readonly persona?: string;\n    readonly toolFilter?: ToolRestriction;\n}',
-    },
     {
         name: 'CordisDynamicPackageId',
         declaration: 'export type CordisDynamicPackageId = Branded<\'CordisDynamicPackageId\'>;',
@@ -4934,10 +5039,22 @@ export const TYPE_API = [
         name: 'CordisRuntimeTreeReader',
         declaration: 'export interface CordisRuntimeTreeReader {\n    getTree(): Promise<CordisRuntimeTree>;\n}',
     },
+    {
+        name: 'CotTranslationPreferences',
+        declaration: 'export interface CotTranslationPreferences {\n    provider: TranslationProvider;\n    targetLanguage: string;\n}',
+    },
+    {
+        name: 'CotTranslationSnapshot',
+        declaration: 'export interface CotTranslationSnapshot {\n    maxTextChars: number;\n    preferences: CotTranslationPreferences;\n    availableProviders: readonly TranslationProvider[];\n}',
+    },
     {
         name: 'CreateAgentOptions',
         declaration: 'export interface CreateAgentOptions {\n    readonly sessionId: SessionId;\n    readonly parentAgent?: Agent;\n    readonly meta?: {\n        readonly cwd?: string;\n        readonly parentSession?: SessionId;\n        readonly isSeeded?: boolean;\n        readonly origin?: \'subagent\';\n        readonly delegationDepth?: number;\n        readonly agentPreset?: string;\n    };\n    readonly inheritedEventCount?: SessionLogOffset;\n    readonly seed?: readonly SessionEvent[];\n    readonly agentOptions?: AgentOptions;\n    readonly signal?: AbortSignal;\n    readonly setup?: AgentSetup;\n}',
     },
+    {
+        name: 'CreatedWorktree',
+        declaration: 'export interface CreatedWorktree {\n    path: string;\n    branch: string;\n    baseCommit: string;\n    repositoryRoot: string;\n}',
+    },
     {
         name: 'CreateGoalRequest',
         declaration: 'export interface CreateGoalRequest {\n    readonly objective: string;\n    readonly maxGoalRounds?: number;\n}',
@@ -4954,6 +5071,10 @@ export const TYPE_API = [
         name: 'CreateTeamTaskRequest',
         declaration: 'export interface CreateTeamTaskRequest {\n    readonly subject: string;\n    readonly description: string;\n    readonly blockedBy?: readonly TeamTaskId[];\n    readonly writeScopes?: readonly string[];\n}',
     },
+    {
+        name: 'CreateWorktreeRequest',
+        declaration: 'export interface CreateWorktreeRequest {\n    name?: string;\n    from?: string;\n}',
+    },
     {
         name: 'CredentialInfo',
         declaration: 'export interface CredentialInfo {\n    configured: boolean;\n    source?: string;\n    writable: boolean;\n}',
@@ -5144,7 +5265,7 @@ export const TYPE_API = [
     },
     {
         name: 'EventLogOptions',
-        declaration: 'export interface EventLogOptions {\n    exporter: SessionLogOptions[\'exporter\'];\n    resourceAttributes: Attributes;\n    scope: {\n        name: string;\n        version?: string;\n    };\n    processor: Omit<BatchLogRecordProcessorOptions, \'exporter\'>;\n    onFailure: SessionLogOptions[\'onFailure\'];\n}',
+        declaration: 'export interface EventLogOptions {\n    exporter: LogExporterOptions;\n    resourceAttributes: Attributes;\n    scope: {\n        name: string;\n        version?: string;\n    };\n    processor: Omit<BatchLogRecordProcessorOptions, \'exporter\'>;\n    onFailure: SessionLogOptions[\'onFailure\'];\n}',
     },
     {
         name: 'EventLogReporter',
@@ -5392,7 +5513,7 @@ export const TYPE_API = [
     },
     {
         name: 'InstallBundleOptions',
-        declaration: 'export interface InstallBundleOptions {\n    enabled?: boolean;\n    requestId?: PluginInstallRequestId;\n    approvedBuilds?: string[];\n    registry?: Registry;\n}',
+        declaration: 'export interface InstallBundleOptions {\n    enabled?: boolean;\n    saveExact?: boolean;\n    requestId?: PluginInstallRequestId;\n    approvedBuilds?: string[];\n    registry?: Registry;\n}',
     },
     {
         name: 'InstallSpecKind',
@@ -5496,7 +5617,7 @@ export const TYPE_API = [
     },
     {
         name: 'JobKindMap',
-        declaration: 'export interface JobKindMap {\n    bash: \'bash\';\n    subagent: \'subagent\';\n}',
+        declaration: 'export interface JobKindMap {\n    bash: \'bash\';\n}',
     },
     {
         name: 'JobListFrame',
@@ -5584,12 +5705,16 @@ export const TYPE_API = [
     },
     {
         name: 'LlmCallConfig',
-        declaration: 'export interface LlmCallConfig {\n    provider: string;\n    model: string;\n    reasoningEffort?: ReasoningEffortId;\n    temperature?: number;\n    maxTokens?: number;\n    stop?: string[];\n}',
+        declaration: 'export interface LlmCallConfig extends LlmCallControls {\n    provider: string;\n    model: string;\n}',
     },
     {
         name: 'LlmCallConfigAdapterDefaults',
         declaration: 'export interface LlmCallConfigAdapterDefaults {\n    reasoningEffort?: true;\n    maxTokens?: true;\n}',
     },
+    {
+        name: 'LlmCallControls',
+        declaration: 'export interface LlmCallControls {\n    reasoningEffort?: ReasoningEffortId;\n    temperature?: number;\n    maxTokens?: number;\n    stop?: string[];\n}',
+    },
     {
         name: 'LlmConfigurableProvider',
         declaration: 'export interface LlmConfigurableProvider {\n    provider: string;\n    displayName: string;\n    settingsNs: string;\n    settingsPath: readonly string[];\n    declared?: boolean;\n    error?: string;\n}',
@@ -5640,7 +5765,7 @@ export const TYPE_API = [
     },
     {
         name: 'LlmRuntime',
-        declaration: 'export class LlmRuntime extends TypertRemoteService {\n    constructor(ctx: Context);\n    registerAdapter(providers: string[], adapter: LlmAdapter): AdapterRegistrationHandle;\n    @Remote\n    listProviders(): LlmProviderInfo[];\n    registerConfigurableProviders(entries: readonly LlmConfigurableProvider[]): DirectoryRegistrationHandle;\n    @Remote\n    listConfigurableProviders(): LlmConfigurableProvider[];\n    registerModelDiscovery(settingsNs: string, discover: (request: LlmModelDiscoveryRequest, signal?: AbortSignal) => Promise<readonly LlmDiscoveredModel[]>): () => void;\n    async discoverModels(settingsNs: string, request: LlmModelDiscoveryRequest, signal?: AbortSignal): Promise<LlmDiscoveredModel[]>;\n    @Remote(\'discoverModels\')\n    async remoteDiscoverModels(settingsNs: string, request: LlmModelDiscoveryRequest, signal: AbortSignal): Promise<LlmDiscoveredModel[]>;\n    providerRetryPolicy(provider: string): ResolvedRetryPolicy;\n    imageRequestPricing(provider: string, model: string): LlmImageRequestPricing | undefined;\n    fileRequestText(ref: FileAttachmentRef): string;\n    async listModels(provider: string): Promise<LlmModelInfo[]>;\n    async resolveModelInfo(provider: string, model: string, signal?: AbortSignal): Promise<LlmResolvedModelInfo>;\n    async resolveCallConfig(config: LlmCallConfig, signal?: AbortSignal): Promise<LlmCallConfig>;\n    async prepareCall(config: LlmCallConfig, signal?: AbortSignal): Promise<PreparedLlmCall>;\n    stream(options: GenerateOptions) /* …truncated — full shape in source */',
+        declaration: 'export class LlmRuntime extends TypertRemoteService {\n    constructor(ctx: Context);\n    registerAdapter(providers: string[], adapter: LlmAdapter): AdapterRegistrationHandle;\n    @Remote\n    listProviders(): LlmProviderInfo[];\n    registerConfigurableProviders(entries: readonly LlmConfigurableProvider[]): DirectoryRegistrationHandle;\n    @Remote\n    listConfigurableProviders(): LlmConfigurableProvider[];\n    registerModelDiscovery(settingsNs: string, discover: (request: LlmModelDiscoveryRequest, signal?: AbortSignal) => Promise<readonly LlmDiscoveredModel[]>): () => void;\n    async discoverModels(settingsNs: string, request: LlmModelDiscoveryRequest, signal?: AbortSignal): Promise<LlmDiscoveredModel[]>;\n    @Remote(\'discoverModels\')\n    async remoteDiscoverModels(settingsNs: string, request: LlmModelDiscoveryRequest, signal: AbortSignal): Promise<LlmDiscoveredModel[]>;\n    providerRetryPolicy(provider: string): ResolvedRetryPolicy;\n    imageRequestPricing(provider: string, model: string): LlmImageRequestPricing | undefined;\n    fileRequestText(ref: FileAttachmentRef): string;\n    async listModels(provider: string): Promise<LlmModelInfo[]>;\n    async resolveModelInfo(provider: string, model: string, signal?: AbortSignal): Promise<LlmResolvedModelInfo>;\n    async resolveCallConfig(config: LlmCallConfig, signal?: AbortSignal): Promise<LlmCallConfig>;\n    async prepareCall(config: LlmCallConfig, signal?: AbortSignal, configure?: ConfigureCall): Promise<PreparedLlmCall>;\n    strea /* …truncated — full shape in source */',
     },
     {
         name: 'LocalAtInput',
@@ -5650,6 +5775,10 @@ export const TYPE_API = [
         name: 'LocalizedText',
         declaration: 'export type LocalizedText = string | {\n    readonly en: string;\n    readonly [locale: string]: string;\n};',
     },
+    {
+        name: 'LogExporterOptions',
+        declaration: 'export type LogExporterOptions = Omit<OTLPExporterNodeConfigBase, \'selfObsMeterProvider\'> & {\n    url: string;\n};',
+    },
     {
         name: 'LspHover',
         declaration: 'export interface LspHover {\n    readonly contents: string;\n    readonly range?: LspRange;\n}',
@@ -5914,10 +6043,6 @@ export const TYPE_API = [
         name: 'OneShotScheduleRecord',
         declaration: 'export type OneShotScheduleRecord = AfterScheduleRecord | AtScheduleRecord;',
     },
-    {
-        name: 'OneShotSubagentDescriptorData',
-        declaration: 'export interface OneShotSubagentDescriptorData extends SubagentDescriptorBase {\n    readonly mode: \'one-shot\';\n    readonly label?: string;\n}',
-    },
     {
         name: 'OptionalSessionSeq',
         declaration: 'export type OptionalSessionSeq = SessionSeq | null;',
@@ -5934,6 +6059,14 @@ export const TYPE_API = [
         name: 'PackageResult',
         declaration: 'export interface PackageResult {\n    exitCode: number;\n    output: string;\n    truncated: boolean;\n    logPath: string;\n    kind?: PluginInstallFailureKind;\n    timedOut?: boolean;\n    incompatible?: IncompatiblePlugin[];\n}',
     },
+    {
+        name: 'PaidTranslationProvider',
+        declaration: 'export type PaidTranslationProvider = \'deepseek-account\' | \'deepseek-official\';',
+    },
+    {
+        name: 'PaidTranslationSpec',
+        declaration: 'export interface PaidTranslationSpec extends TranslationSpecFields {\n    readonly provider: PaidTranslationProvider;\n    readonly sessionId: SessionId;\n}',
+    },
     {
         name: 'PaneOpenArgs',
         declaration: 'export interface PaneOpenArgs {\n    id: string;\n    title?: string;\n    focus?: true;\n    closeOnEscape?: true;\n    holdToasts?: true;\n    rows?: number;\n    columns?: number;\n}',
@@ -6116,7 +6249,7 @@ export const TYPE_API = [
     },
     {
         name: 'PromptContext',
-        declaration: 'export interface PromptContext {\n    readonly name: string;\n    readonly order: number;\n    readonly text: string | ((context: AssembleContext) => string);\n}',
+        declaration: 'export interface PromptContext {\n    readonly name: string;\n    readonly order: number;\n    readonly text: string | ((context: AssembleContext) => string);\n    readonly interpolate?: boolean;\n    readonly required?: boolean;\n}',
     },
     {
         name: 'PromptContextOrderName',
@@ -6316,7 +6449,7 @@ export const TYPE_API = [
     },
     {
         name: 'ResolvedSubagentStartRequest',
-        declaration: 'export interface ResolvedSubagentStartRequest extends SubagentStartRequest {\n    readonly descriptor: SubagentDescriptorData;\n}',
+        declaration: 'export interface ResolvedSubagentStartRequest extends SubagentStartRequest {\n    readonly cwd: string;\n}',
     },
     {
         name: 'RestoredSessionOptions',
@@ -6480,7 +6613,7 @@ export const TYPE_API = [
     },
     {
         name: 'SendTeamMessageResult',
-        declaration: 'export interface SendTeamMessageResult {\n    readonly messageId: TeamMessageId;\n    readonly status: \'accepted\' | \'queued\';\n}',
+        declaration: 'export interface SendTeamMessageResult {\n    readonly messageId: MessageId;\n}',
     },
     {
         name: 'SerializedElement',
@@ -6676,7 +6809,7 @@ export const TYPE_API = [
     },
     {
         name: 'SessionForkRequest',
-        declaration: 'export interface SessionForkRequest {\n    readonly sessionId: SessionId;\n    readonly atSeq?: number;\n}',
+        declaration: 'export interface SessionForkRequest {\n    readonly sessionId: SessionId;\n    readonly atSeq?: number;\n    readonly allowMigration?: boolean;\n}',
     },
     {
         name: 'SessionForkSource',
@@ -6744,7 +6877,11 @@ export const TYPE_API = [
     },
     {
         name: 'SessionLogOptions',
-        declaration: 'export interface SessionLogOptions {\n    exporter: OTLPExporterNodeConfigBase & {\n        url: string;\n    };\n    processor?: Omit<BatchLogRecordProcessorOptions, \'exporter\'>;\n    maxRequestBytes?: number;\n    scope: {\n        name: string;\n        version?: string;\n    };\n    resourceAttributes: Attributes;\n    onFailure: (message: string, error?: Error) => void;\n}',
+        declaration: 'export interface SessionLogOptions {\n    exporter: LogExporterOptions;\n    processor?: SessionLogProcessorOptions;\n    maxRequestBytes?: number;\n    scope: {\n        name: string;\n        version?: string;\n    };\n    resourceAttributes: Attributes;\n    onFailure: (message: string, error?: Error) => void;\n}',
+    },
+    {
+        name: 'SessionLogProcessorOptions',
+        declaration: 'export type SessionLogProcessorOptions = Omit<BatchLogRecordProcessorOptions, \'exporter\' | \'selfObsMeterProvider\'>;',
     },
     {
         name: 'SessionLogRecord',
@@ -6812,7 +6949,7 @@ export const TYPE_API = [
     },
     {
         name: 'SessionPersistenceSnapshot',
-        declaration: 'export interface SessionPersistenceSnapshot {\n    readonly header: SessionHeader;\n    readonly revision: SessionPersistenceRevision;\n    readonly eventCount?: number;\n    readonly sizeBytes?: number;\n}',
+        declaration: 'export interface SessionPersistenceSnapshot {\n    readonly header: SessionHeader;\n    readonly formatStatus?: \'current\' | \'migration-required\';\n    readonly revision: SessionPersistenceRevision;\n    readonly eventCount?: number;\n    readonly sizeBytes?: number;\n}',
     },
     {
         name: 'SessionPersistenceStatOptions',
@@ -6840,7 +6977,7 @@ export const TYPE_API = [
     },
     {
         name: 'SessionProjectionsValue',
-        declaration: 'export type SessionProjectionsValue = SessionProjectionBaseline | null;',
+        declaration: 'export type SessionProjectionsValue = (SessionProjectionBaseline & {\n    readonly kind: \'sequenced\';\n}) | {\n    readonly kind: \'migration-required\';\n    readonly values: SessionProjectionValues;\n} | null;',
     },
     {
         name: 'SessionProjectionUpdate',
@@ -6864,7 +7001,7 @@ export const TYPE_API = [
     },
     {
         name: 'SessionRecord',
-        declaration: 'export interface SessionRecord {\n    header: SessionHeader;\n    live: boolean;\n    persisted: boolean;\n}',
+        declaration: 'export interface SessionRecord {\n    header: SessionHeader;\n    live: boolean;\n    persisted: boolean;\n    formatStatus?: \'current\' | \'migration-required\';\n}',
     },
     {
         name: 'SessionReferenceCandidate',
@@ -6960,7 +7097,7 @@ export const TYPE_API = [
     },
     {
         name: 'SessionSummary',
-        declaration: 'export interface SessionSummary {\n    readonly agentAvailable: boolean;\n    readonly sessionId: SessionId;\n    readonly updatedAt: number;\n    readonly running: boolean;\n    readonly blank: boolean;\n    readonly parentSessionId?: SessionId;\n    readonly origin?: \'subagent\';\n    readonly cwd?: string;\n    readonly projections?: SessionProjectionHints;\n}',
+        declaration: 'export interface SessionSummary {\n    readonly agentAvailable: boolean;\n    readonly formatStatus?: \'current\' | \'migration-required\';\n    readonly sessionId: SessionId;\n    readonly updatedAt: number;\n    readonly running: boolean;\n    readonly blank: boolean;\n    readonly parentSessionId?: SessionId;\n    readonly origin?: \'subagent\';\n    readonly cwd?: string;\n    readonly projections?: SessionProjectionHints;\n}',
     },
     {
         name: 'SessionSurface',
@@ -7008,7 +7145,7 @@ export const TYPE_API = [
     },
     {
         name: 'SessionTitleProviderRequest',
-        declaration: 'export interface SessionTitleProviderRequest {\n    readonly session: Session;\n    readonly messages: readonly SessionTitleUserMessage[];\n    readonly route?: SessionTitleModelIdentity;\n    readonly signal: AbortSignal;\n}',
+        declaration: 'export interface SessionTitleProviderRequest {\n    readonly session: Session;\n    readonly messages: readonly SessionTitleUserMessage[];\n    readonly route?: SessionTitleModelIdentity;\n    readonly currentTitle?: SessionTitleSnapshot;\n    readonly signal: AbortSignal;\n}',
     },
     {
         name: 'SessionTitleProviderResult',
@@ -7314,26 +7451,30 @@ export const TYPE_API = [
         name: 'StreamChunk',
         declaration: 'export type StreamChunk = {\n    type: \'block-start\';\n    index: number;\n    blockType: ContentBlockType;\n} | {\n    type: \'text-delta\';\n    index: number;\n    text: string;\n} | {\n    type: \'reasoning-delta\';\n    index: number;\n    text: string;\n} | {\n    type: \'tool-call-delta\';\n    index: number;\n    id: ToolCallId;\n    name?: string;\n    argumentsDelta: string;\n} | {\n    type: \'block-end\';\n    index: number;\n    block: ContentBlock;\n} | {\n    type: \'usage\';\n    usage: TokenUsage;\n} | {\n    type: \'finish\';\n    reason: FinishReason;\n    replayState?: ReplayEnvelope;\n};',
     },
+    {
+        name: 'SubagentActivation',
+        declaration: 'export interface SubagentActivation {\n    readonly childId: SessionId;\n    readonly messageId?: MessageId;\n    readonly result: Promise<SubagentResult>;\n    dispose(): Promise<void>;\n}',
+    },
+    {
+        name: 'SubagentActivationSpec',
+        declaration: 'export interface SubagentActivationSpec {\n    readonly provider: string;\n    readonly label: string;\n    readonly childId?: SessionId;\n    readonly request: Omit<SubagentStartRequest, \'label\' | \'signal\'>;\n    readonly signal: AbortSignal;\n    readonly delivery: \'parent\' | \'caller\';\n}',
+    },
     {
         name: 'SubagentCapabilities',
         declaration: 'export interface SubagentCapabilities {\n    readonly agentOptions: boolean;\n    readonly outputSchema: boolean;\n    readonly depthLimit: boolean;\n    readonly toolFilter: boolean;\n    readonly persona: boolean;\n}',
     },
     {
         name: 'SubagentCatalogEntry',
-        declaration: 'export type SubagentCatalogEntry = {\n    readonly id: SessionId;\n    readonly createdAt: number;\n} & ({\n    readonly mode: \'one-shot\';\n    readonly label?: string;\n} | {\n    readonly mode: \'continuable\';\n    readonly label: string;\n} | {\n    readonly mode: \'unknown\';\n    readonly label?: string;\n});',
+        declaration: 'export type SubagentCatalogEntry = {\n    readonly id: SessionId;\n    readonly createdAt: number;\n} & ({\n    readonly mode: \'one-shot\';\n    readonly label?: string;\n} | {\n    readonly mode: \'external\';\n    readonly label?: string;\n} | {\n    readonly mode: \'continuable\';\n    readonly label: string;\n} | {\n    readonly mode: \'unknown\';\n    readonly label?: string;\n});',
     },
     {
         name: 'SubagentCatalogRow',
-        declaration: 'export type SubagentCatalogRow = {\n    readonly id: SessionId;\n    readonly activity: \'running\' | \'inactive\';\n} & ({\n    readonly mode: \'one-shot\';\n    readonly label?: string;\n} | {\n    readonly mode: \'continuable\';\n    readonly label: string;\n});',
+        declaration: 'export type SubagentCatalogRow = {\n    readonly id: SessionId;\n    readonly activity: \'running\' | \'inactive\';\n} & ({\n    readonly mode: \'one-shot\';\n    readonly label?: string;\n} | {\n    readonly mode: \'external\';\n    readonly label?: string;\n} | {\n    readonly mode: \'continuable\';\n    readonly label: string;\n});',
     },
     {
         name: 'SubagentDescendantListEntry',
         declaration: 'export type SubagentDescendantListEntry = SubagentListEntry & {\n    readonly parentId: SessionId;\n    readonly depth: number;\n};',
     },
-    {
-        name: 'SubagentDescriptorData',
-        declaration: 'export type SubagentDescriptorData = OneShotSubagentDescriptorData | ContinuableSubagentDescriptorData;',
-    },
     {
         name: 'SubagentInterruptAuthority',
         declaration: 'export type SubagentInterruptAuthority = {\n    readonly kind: \'user\';\n    readonly parentSessionId: SessionId;\n} | {\n    readonly kind: \'ancestor\';\n    readonly agent: Agent;\n};',
@@ -7360,7 +7501,7 @@ export const TYPE_API = [
     },
     {
         name: 'SubagentProvider',
-        declaration: 'export interface SubagentProvider {\n    readonly name: string;\n    readonly capabilities: SubagentCapabilities;\n    readonly inheritsParentContext: boolean;\n    readonly agentRouteDefaults?: Readonly<{\n        provider: string;\n        model: string;\n    }>;\n    start(request: ResolvedSubagentStartRequest): Promise<SubagentRun>;\n    prepareContinuable?(request: ContinuableCreateRequest): Promise<ContinuableCreateSpec>;\n}',
+        declaration: 'export interface SubagentProvider {\n    readonly name: string;\n    readonly capabilities: SubagentCapabilities;\n    readonly inheritsParentContext: boolean;\n    readonly agentRouteDefaults?: Readonly<{\n        provider: string;\n        model: string;\n    }>;\n    start?(request: ResolvedSubagentStartRequest): Promise<SubagentRun>;\n    prepareContinuable?(request: ContinuableCreateRequest): Promise<ContinuableCreateSpec>;\n}',
     },
     {
         name: 'SubagentResult',
@@ -7368,7 +7509,7 @@ export const TYPE_API = [
     },
     {
         name: 'SubagentRun',
-        declaration: 'export interface SubagentRun {\n    readonly id: SessionId;\n    readonly localAgent: Agent | undefined;\n    readonly result: Promise<SubagentResult>;\n    dispose(): Promise<void>;\n}',
+        declaration: 'export interface SubagentRun {\n    readonly id: SessionId;\n    readonly result: Promise<SubagentResult>;\n    dispose(): Promise<void>;\n}',
     },
     {
         name: 'SubagentRunEndInfo',
@@ -7384,7 +7525,7 @@ export const TYPE_API = [
     },
     {
         name: 'SubagentRuntime',
-        declaration: 'export class SubagentRuntime extends TypertRemoteService {\n    static Config;\n    constructor(ctx: Context, private config: Config);\n    resolveMaxDepth(configured?: number | \'provider-managed\'): number | undefined;\n    async startContinuable(spec: ContinuableStartSpec): Promise<ContinuableStart>;\n    async sendMessage(sender: Agent, targetId: SessionId, content: ContentBlock[], options: SubagentSendMessageOptions): Promise<MessageId>;\n    interrupt(targetSessionId: SessionId, authority: SubagentInterruptAuthority): void;\n    async drainContinuableDescendants(parents: readonly Agent[]): Promise<void>;\n    async drainContinuableChildren(parent: Agent, childIds: readonly SessionId[]): Promise<void>;\n    listChildren(parentSessionId: SessionId, signal?: AbortSignal): Promise<SubagentCatalogEntry[]>;\n    listDescendants(rootSessionId: SessionId, signal?: AbortSignal): Promise<SubagentDescendantListEntry[]>;\n    @Remote(\'prompt\')\n    async prompt(request: SubagentPromptRequest, signal: AbortSignal): Promise<SubagentPromptReceipt>;\n    @Remote(\'interruptByParent\')\n    interruptByParent(childSessionId: SessionId, parentSessionId: SessionId, mode: \'continuable\'): SubagentInterruptReceipt;\n    registerProvider(provider: SubagentProvider): () => void;\n    getProvider(name: string): SubagentProvider | undefined;\n    list(): string[];\n    async start(name: string, request: SubagentStartRequest): Promise<SubagentRun>;\n}',
+        declaration: 'export class SubagentRuntime extends TypertRemoteService {\n    static Config;\n    static inject;\n    constructor(ctx: Context, private config: Config);\n    resolveMaxDepth(configured?: number | \'provider-managed\'): number | undefined;\n    startActivation(spec: SubagentActivationSpec & {\n        readonly childId: SessionId;\n    }): Promise<SubagentActivation & {\n        readonly messageId: MessageId;\n    }>;\n    startActivation(spec: SubagentActivationSpec): Promise<SubagentActivation>;\n    async startActivation(spec: SubagentActivationSpec): Promise<SubagentActivation>;\n    async waitForChildren(parent: Agent): Promise<boolean>;\n    async sendMessage(sender: Agent, targetId: SessionId, content: ContentBlock[], options: SubagentSendMessageOptions): Promise<MessageId>;\n    interrupt(targetSessionId: SessionId, authority: SubagentInterruptAuthority): void;\n    async drainDescendants(parents: readonly Agent[]): Promise<void>;\n    async drainChildren(parent: Agent, childIds: readonly SessionId[]): Promise<void>;\n    listChildren(parentSessionId: SessionId, signal?: AbortSignal): Promise<SubagentCatalogEntry[]>;\n    listDescendants(rootSessionId: SessionId, signal?: AbortSignal): Promise<SubagentDescendantListEntry[]>;\n    @Remote(\'prompt\')\n    async prompt(request: SubagentPromptRequest, signal: AbortSignal): Promise<SubagentPromptReceipt>;\n    @Remote(\'interruptByParent\')\n    interruptByParent(childSessionId: SessionId, parentSessionId: SessionId, mode: \'continuable\'): SubagentIn /* …truncated — full shape in source */',
     },
     {
         name: 'SubagentSendMessageOptions',
@@ -7396,7 +7537,7 @@ export const TYPE_API = [
     },
     {
         name: 'SubagentStartRequest',
-        declaration: 'export interface SubagentStartRequest {\n    readonly label?: string;\n    readonly prompt: ContentBlock[];\n    readonly parent: Agent;\n    readonly signal: AbortSignal;\n    readonly agentOptions?: AgentOptions;\n    readonly outputSchema?: ObjectJsonSchema;\n    readonly maxDepth?: number;\n    readonly toolFilter?: ToolRestriction;\n    readonly persona?: string;\n}',
+        declaration: 'export interface SubagentStartRequest {\n    readonly cwd?: string;\n    readonly label?: string;\n    readonly prompt: ContentBlock[];\n    readonly parent: Agent;\n    readonly signal: AbortSignal;\n    readonly agentOptions?: AgentOptions;\n    readonly outputSchema?: ObjectJsonSchema;\n    readonly maxDepth?: number;\n    readonly toolFilter?: ToolRestriction;\n    readonly persona?: string;\n}',
     },
     {
         name: 'SubagentStopReason',
@@ -7496,7 +7637,7 @@ export const TYPE_API = [
     },
     {
         name: 'SystemPrompt',
-        declaration: 'export class SystemPrompt extends Service {\n    static Config: z<Config>;\n    constructor(ctx: Context, config: Config);\n    section(section: PromptSection): () => void;\n    getSectionOrder(name: PromptSectionOrderName): number;\n    getContextOrder(name: PromptContextOrderName): number;\n    context(context: PromptContext): () => void;\n    suppressRuntimeContext(): () => void;\n    tools(provider: (context: AssembleContext) => ToolProviderResult): () => void;\n    variable(name: string, provider: (context: AssembleContext) => string | undefined): () => void;\n    async assemble(context: AssembleContext = {}): Promise<PromptAssembly>;\n}',
+        declaration: 'export class SystemPrompt extends Service {\n    static Config: z<Config>;\n    constructor(ctx: Context, config: Config);\n    section(section: PromptSection): () => void;\n    getSectionOrder(name: PromptSectionOrderName): number;\n    getContextOrder(name: PromptContextOrderName): number;\n    context(context: PromptContext): () => void;\n    suppressRuntimeContext(): () => void;\n    tools(provider: (context: AssembleContext) => ToolProviderResult): () => void;\n    variable(name: string, provider: (context: AssembleContext) => string | undefined): () => void;\n    refreshContext(assembly: PromptAssembly, context: AssembleContext = {}): PromptAssembly;\n    async assemble(context: AssembleContext = {}): Promise<PromptAssembly>;\n}',
     },
     {
         name: 'SystemPromptMessageSource',
@@ -7526,10 +7667,6 @@ export const TYPE_API = [
         name: 'TeamMemberView',
         declaration: 'export interface TeamMemberView {\n    readonly id: SessionId;\n    readonly name: string;\n    readonly role: \'lead\' | \'teammate\';\n    readonly status: \'running\' | \'inactive\' | \'provisioning\' | \'failed\';\n    readonly description?: string;\n    readonly provider?: string;\n    readonly context?: \'fresh\' | \'fork\';\n    readonly model?: string;\n    readonly diagnostics: string[];\n}',
     },
-    {
-        name: 'TeamMessageId',
-        declaration: 'export type TeamMessageId = Branded<\'TeamMessageId\'>;',
-    },
     {
         name: 'TeamTaskAction',
         declaration: 'export type TeamTaskAction = \'claim\' | \'release\' | \'edit\' | \'set_dependencies\' | \'complete\' | \'reopen\' | \'reassign\' | \'delete\';',
@@ -7780,7 +7917,7 @@ export const TYPE_API = [
     },
     {
         name: 'ToolPresentationMode',
-        declaration: 'export type ToolPresentationMode = \'native\' | \'ptc\' | \'both\';',
+        declaration: 'export type ToolPresentationMode = \'native\' | \'ptc\';',
     },
     {
         name: 'ToolProviderResult',
@@ -7842,6 +7979,18 @@ export const TYPE_API = [
         name: 'TranscriptionRequest',
         declaration: 'export interface TranscriptionRequest {\n    readonly audioBase64: string;\n    readonly providerId?: SpeechProviderId;\n    readonly language?: string;\n}',
     },
+    {
+        name: 'TranslationProvider',
+        declaration: 'export type TranslationProvider = AnonymousTranslationProvider | PaidTranslationProvider;',
+    },
+    {
+        name: 'TranslationRequest',
+        declaration: 'export interface TranslationRequest {\n    readonly text: string;\n    readonly targetLanguage: string;\n    readonly sourceLanguage?: string;\n    readonly provider?: TranslationProvider;\n    readonly sessionId?: SessionId;\n}',
+    },
+    {
+        name: 'TranslationSpec',
+        declaration: 'export type TranslationSpec = AnonymousTranslationSpec | PaidTranslationSpec;',
+    },
     {
         name: 'TurnCompleteInput',
         declaration: 'export interface TurnCompleteInput {\n    turnId: string;\n    answer: string;\n    durationMs: number;\n    isAborted: boolean;\n    reason: \'answer\' | \'aborted\' | \'error\';\n    agentId?: string;\n    usage?: TurnUsage;\n}',

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@deepseek-ai/dsh-tool-cordis",
   "description": "Read-only runtime API inspection for Harness plugin development",
-  "version": "0.2.1-alpha.1",
+  "version": "0.2.1-alpha.2",
   "publishConfig": {
     "access": "public"
   },
@@ -34,20 +34,20 @@
   "peerDependencies": {
     "@deepseek-ai/cordis": "~4.0.5-alpha.1",
     "@deepseek-ai/cordis-plugin-loader": "~1.0.6-alpha.1",
-    "@deepseek-ai/dsh-agent": "0.2.1-alpha.1",
-    "@deepseek-ai/dsh-app-boot": "0.2.1-alpha.1",
-    "@deepseek-ai/dsh-cordis-host-runner": "0.2.1-alpha.1",
-    "@deepseek-ai/dsh-tools": "0.2.1-alpha.1"
+    "@deepseek-ai/dsh-agent": "0.2.1-alpha.2",
+    "@deepseek-ai/dsh-app-boot": "0.2.1-alpha.2",
+    "@deepseek-ai/dsh-cordis-host-runner": "0.2.1-alpha.2",
+    "@deepseek-ai/dsh-tools": "0.2.1-alpha.2"
   },
   "devDependencies": {
     "@deepseek-ai/cordis": "~4.0.5-alpha.1",
     "@deepseek-ai/cordis-plugin-group": "~1.0.5-alpha.1",
     "@deepseek-ai/cordis-plugin-loader": "~1.0.6-alpha.1",
-    "@deepseek-ai/dsh-agent": "0.2.1-alpha.1",
-    "@deepseek-ai/dsh-app-boot": "0.2.1-alpha.1",
-    "@deepseek-ai/dsh-cordis-host-runner": "0.2.1-alpha.1",
-    "@deepseek-ai/dsh-system-prompt": "0.2.1-alpha.1",
-    "@deepseek-ai/dsh-tools": "0.2.1-alpha.1",
+    "@deepseek-ai/dsh-agent": "0.2.1-alpha.2",
+    "@deepseek-ai/dsh-app-boot": "0.2.1-alpha.2",
+    "@deepseek-ai/dsh-cordis-host-runner": "0.2.1-alpha.2",
+    "@deepseek-ai/dsh-system-prompt": "0.2.1-alpha.2",
+    "@deepseek-ai/dsh-tools": "0.2.1-alpha.2",
     "@deepseek-ai/schemastery": "~3.18.5-alpha.1"
   }
 }