@deepseek-ai/dsh-subagent 0.1.5-rc.2 → 0.1.6-alpha.2

package/lib/types/continuation-messages.d.ts

@@ -53,7 +53,7 @@ export declare function createAgentMessage(sender: Agent, content: ContentBlock[
  */
 export declare function withContinuableReturnGuidance(parentId: SessionId, prompt: ContentBlock[]): ContentBlock[];
 /**
- * Build the runtime-owned settlement notice delivered to a child's parent.
+ * Build the runtime-owned settlement notice from the child's nonempty closing text.
  * @param childId - durable child session id named in the notice.
  * @param terminal - recorded terminal state for the settled Activation.
  * @returns the durable user-message representation delivered to the parent.

package/lib/types/continuation-messages.js

@@ -77,19 +77,23 @@ function settlementSummary(childId, stopReason) {
     }
 }
 /**
- * Build the runtime-owned settlement notice delivered to a child's parent.
+ * Build the runtime-owned settlement notice from the child's nonempty closing text.
  * @param childId - durable child session id named in the notice.
  * @param terminal - recorded terminal state for the settled Activation.
  * @returns the durable user-message representation delivered to the parent.
  */
 export function createSettlementMessage(childId, terminal) {
     const summary = settlementSummary(childId, terminal.stopReason);
+    // Parent providers receive this notice as a user message and may reject
+    // nontext assistant blocks. Keep this conversion local so SDK/UI consumers
+    // retain the complete child output.
+    const closingText = (terminal.output ?? []).flatMap(block => block.type === 'text' && block.text.length > 0 ? [block] : []);
     return createUserMessage({
         content: [
             { type: 'text', text: summary },
-            ...terminal.output === undefined
+            ...closingText.length === 0
                 ? [{ type: 'text', text: 'It left no closing message.' }]
-                : [{ type: 'text', text: 'Its closing message:' }, ...terminal.output],
+                : [{ type: 'text', text: 'Its closing message:' }, ...closingText],
         ],
         source: {
             kind: 'subagent-settled',

package/lib/types/continuation.d.ts

@@ -35,7 +35,7 @@ export declare class SubagentContinuationManager {
     private readonly ctx;
     private readonly host;
     private readonly activations;
-    constructor(ctx: Context, host: ContinuationHost);
+    constructor(ctx: Context, host: ContinuationHost, maxActiveSubagents: () => number);
     /**
      * Start one continuable background child and resolve at initial inbox acceptance.
      * Every earlier failure disposes any created handle and rolls back Activation

package/lib/types/continuation.js

@@ -86,10 +86,10 @@ export class SubagentContinuationManager {
     ctx;
     host;
     activations;
-    constructor(ctx, host) {
+    constructor(ctx, host, maxActiveSubagents) {
         this.ctx = ctx;
         this.host = host;
-        this.activations = new ContinuableActivationRegistry(ctx, (provider, childId, parent) => host.observeActivation(provider, childId, parent));
+        this.activations = new ContinuableActivationRegistry(ctx, (provider, childId, parent) => host.observeActivation(provider, childId, parent), maxActiveSubagents);
     }
     /**
      * Start one continuable background child and resolve at initial inbox acceptance.

package/lib/types/control.js

@@ -100,6 +100,7 @@ export function rejectPrompt(error, childSessionId, signal) {
                 throw new RemoteError('subagent/unauthorized', 'subagent does not belong to this parent', { childSessionId }, { cause: error });
             case 'DRAINING':
             case 'ACTIVATION_CLOSING':
+            case 'ACTIVATION_LIMIT_REACHED':
             case 'CONTINUATION_UNAVAILABLE':
             case 'PERSISTENCE_UNAVAILABLE':
                 throw new RemoteError('subagent/delivery-unavailable', 'subagent follow-up is temporarily unavailable', { childSessionId }, { cause: error });

package/lib/types/index.d.ts

@@ -29,6 +29,7 @@
  * @module @deepseek-ai/dsh-subagent
  */
 import { Context } from '@deepseek-ai/cordis';
+import z from '@deepseek-ai/schemastery';
 import type { Scoped } from '@deepseek-ai/dsh-scope';
 import type { ContentBlock, MessageId } from '@deepseek-ai/dsh-llm';
 import type { Agent } from '@deepseek-ai/dsh-agent';
@@ -94,8 +95,17 @@ declare module '@deepseek-ai/cordis' {
         'subagent/end'(this: Scoped<SubagentRuntime>, info: SubagentRunEndInfo): void;
     }
 }
+/** Host configuration for continuable subagent capacity. */
+export interface Config {
+    /** Maximum live children sharing uninterrupted continuable parent links; defaults to 8. */
+    maxActiveSubagents?: number;
+    /** Default delegation depth for tools without an explicit limit; defaults to 1. */
+    maxDepth?: number;
+}
 /** Named provider registry with one-shot runs, durable discovery, and continuable-child operations. */
 export declare class SubagentRuntime extends TypertRemoteService {
+    static Config: z<Config>;
+    private settingsSource;
     private providers;
     private continuations;
     /**
@@ -104,7 +114,13 @@ export declare class SubagentRuntime extends TypertRemoteService {
      * composes into the carrier.
      */
     private readonly emitLifecycle;
-    constructor(ctx: Context);
+    constructor(ctx: Context, config: Config);
+    /**
+     * Resolve a delegation tool's depth policy against the current user setting.
+     * @param configured - Explicit tool limit, or provider-managed for external delegation.
+     * @returns The numeric limit, or undefined when the provider owns depth enforcement.
+     */
+    resolveMaxDepth(configured?: number | 'provider-managed'): number | undefined;
     /**
      * Establish one durable continuable child and deliver its initial prompt.
      * Resolves when the child's inbox accepts that prompt, without waiting for the
@@ -132,12 +148,12 @@ export declare class SubagentRuntime extends TypertRemoteService {
     sendMessage(sender: Agent, targetId: SessionId, content: ContentBlock[], options: SubagentSendMessageOptions): Promise<MessageId>;
     /**
      * Deliver one host-protocol message to a direct continuable child.
-     * Symbol-keyed so host adapters can preserve their own provenance without
+     * Symbol-keyed so host adapters can preserve their own source descriptors without
      * widening the public Service Definition or impersonating an Agent sender.
      * @param parent - exact live direct parent authorizing delivery.
      * @param childId - durable direct-child session id.
      * @param content - host-authored content to deliver.
-     * @param source - durable host-protocol provenance.
+     * @param source - durable host-protocol source descriptor.
      * @param signal - caller cancellation before inbox acceptance.
      * @param delivery - Queue as a distinct turn or Steer at the nearest step.
      * @returns the accepted message's inbox id.
@@ -238,6 +254,7 @@ export declare class SubagentRuntime extends TypertRemoteService {
      * nearest step and retains the Agent loop's best-effort fallback semantics.
      * Image parts are admitted and persisted through the attachment store
      * before delivery, and the child's model must accept image input.
+     * Cold resume at capacity rejects with `subagent/delivery-unavailable`.
      * @param request - durable address, delivery, minted identity, content, and optional browser zone.
      * @param signal - carrier cancellation, owning the call until inbox acceptance.
      * @returns the accepted message's inbox identity.

package/lib/types/index.js

@@ -62,6 +62,7 @@ var __esDecorate = (this && this.__esDecorate) || function (ctor, descriptorIn,
     if (target) Object.defineProperty(target, contextIn.name, descriptor);
     done = true;
 };
+import z from '@deepseek-ai/schemastery';
 import { scopeTarget } from '@deepseek-ai/dsh-scope';
 import { assertObjectJsonSchema } from '@deepseek-ai/dsh-tools';
 import { canonicalClientTimeZone } from '@deepseek-ai/dsh-util-time';
@@ -102,7 +103,12 @@ let SubagentRuntime = (() => {
             __esDecorate(this, null, _interruptByParent_decorators, { kind: "method", name: "interruptByParent", static: false, private: false, access: { has: obj => "interruptByParent" in obj, get: obj => obj.interruptByParent }, metadata: _metadata }, null, _instanceExtraInitializers);
             if (_metadata) Object.defineProperty(this, Symbol.metadata, { enumerable: true, configurable: true, writable: true, value: _metadata });
         }
-        providers = (__runInitializers(this, _instanceExtraInitializers), new Map());
+        static Config = z.object({
+            maxDepth: z.number().step(1).min(0).max(Number.MAX_SAFE_INTEGER).default(1),
+            maxActiveSubagents: z.number().step(1).min(1).max(Number.MAX_SAFE_INTEGER).default(8),
+        });
+        settingsSource = __runInitializers(this, _instanceExtraInitializers);
+        providers = new Map();
         continuations;
         /**
          * The contained lifecycle-edge publisher. Built here because scoped dispatch
@@ -110,14 +116,23 @@ let SubagentRuntime = (() => {
          * composes into the carrier.
          */
         emitLifecycle;
-        constructor(ctx) {
+        constructor(ctx, config) {
             super(ctx, 'subagents');
+            assertSubagentMaxDepth(config.maxDepth);
+            this.settingsSource = () => config;
+            ctx.inject(['settings'], (settingsCtx) => {
+                settingsCtx.settings.installSection(ctx, 'subagent', SubagentRuntime.Config, config, {
+                    validate: (value) => { assertSubagentMaxDepth(value.maxDepth); },
+                    setSource: (source) => { this.settingsSource = source; },
+                    onChange: () => { },
+                });
+            });
             this.emitLifecycle = createLifecycleEmitter(this.ctx, parent => scopeTarget(this, parent));
             ctx.inject(['agents'], (childCtx) => {
                 const manager = new SubagentContinuationManager(childCtx, {
                     prepareContinuable: (name, request) => this.prepareContinuable(name, request),
                     observeActivation: (provider, childId, parent) => this.observeActivation(provider, childId, parent),
-                });
+                }, () => this.settingsSource().maxActiveSubagents);
                 this.continuations = manager;
                 childCtx.effect(() => () => {
                     /* v8 ignore else -- one injected binding owns the slot until its fiber disposes. */
@@ -131,6 +146,16 @@ let SubagentRuntime = (() => {
                 projectionCtx.sessionProjections.register(subagentIdentityProjectionDefinition);
             });
         }
+        /**
+         * Resolve a delegation tool's depth policy against the current user setting.
+         * @param configured - Explicit tool limit, or provider-managed for external delegation.
+         * @returns The numeric limit, or undefined when the provider owns depth enforcement.
+         */
+        resolveMaxDepth(configured) {
+            if (configured === 'provider-managed')
+                return undefined;
+            return configured ?? this.settingsSource().maxDepth;
+        }
         /**
          * Establish one durable continuable child and deliver its initial prompt.
          * Resolves when the child's inbox accepts that prompt, without waiting for the
@@ -162,12 +187,12 @@ let SubagentRuntime = (() => {
         }
         /**
          * Deliver one host-protocol message to a direct continuable child.
-         * Symbol-keyed so host adapters can preserve their own provenance without
+         * Symbol-keyed so host adapters can preserve their own source descriptors without
          * widening the public Service Definition or impersonating an Agent sender.
          * @param parent - exact live direct parent authorizing delivery.
          * @param childId - durable direct-child session id.
          * @param content - host-authored content to deliver.
-         * @param source - durable host-protocol provenance.
+         * @param source - durable host-protocol source descriptor.
          * @param signal - caller cancellation before inbox acceptance.
          * @param delivery - Queue as a distinct turn or Steer at the nearest step.
          * @returns the accepted message's inbox id.
@@ -297,6 +322,7 @@ let SubagentRuntime = (() => {
          * nearest step and retains the Agent loop's best-effort fallback semantics.
          * Image parts are admitted and persisted through the attachment store
          * before delivery, and the child's model must accept image input.
+         * Cold resume at capacity rejects with `subagent/delivery-unavailable`.
          * @param request - durable address, delivery, minted identity, content, and optional browser zone.
          * @param signal - carrier cancellation, owning the call until inbox acceptance.
          * @returns the accepted message's inbox identity.

package/lib/types/internal.d.ts

@@ -39,7 +39,7 @@ export interface HostPromptDeliverer {
  * @param parent - exact live direct parent authorizing delivery.
  * @param childId - durable direct-child session id.
  * @param content - host-authored content to deliver.
- * @param source - durable host-protocol provenance.
+ * @param source - durable host-protocol source descriptor.
  * @param signal - caller cancellation before inbox acceptance.
  * @returns the accepted message's inbox id.
  */
@@ -50,7 +50,7 @@ export declare function queueHostSubagentPrompt(runtime: SubagentRuntime, parent
  * @param parent - exact live direct parent authorizing delivery.
  * @param childId - durable direct-child session id.
  * @param content - host-authored content to deliver.
- * @param source - durable host-protocol provenance.
+ * @param source - durable host-protocol source descriptor.
  * @param signal - caller cancellation before inbox acceptance.
  * @returns the accepted message's inbox id.
  */

package/lib/types/internal.js

@@ -35,7 +35,7 @@ export const deliverSubagentPrompt = Symbol.for('dsh.subagent.deliverPrompt');
  * @param parent - exact live direct parent authorizing delivery.
  * @param childId - durable direct-child session id.
  * @param content - host-authored content to deliver.
- * @param source - durable host-protocol provenance.
+ * @param source - durable host-protocol source descriptor.
  * @param signal - caller cancellation before inbox acceptance.
  * @returns the accepted message's inbox id.
  */
@@ -48,7 +48,7 @@ export function queueHostSubagentPrompt(runtime, parent, childId, content, sourc
  * @param parent - exact live direct parent authorizing delivery.
  * @param childId - durable direct-child session id.
  * @param content - host-authored content to deliver.
- * @param source - durable host-protocol provenance.
+ * @param source - durable host-protocol source descriptor.
  * @param signal - caller cancellation before inbox acceptance.
  * @returns the accepted message's inbox id.
  */

package/lib/types/lifecycle.js

@@ -106,6 +106,7 @@ export function createActivationObserver(emit, provider, childId, parent) {
             emit('subagent/start', identity, parent);
         },
         capture: (child) => {
+            // oxlint-disable-next-line typescript/no-deprecated -- Existing Session history read; migration deferred.
             const own = child.session.snapshotEvents(boundary);
             const output = finalAssistantOutput(own);
             captured = {

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@deepseek-ai/dsh-subagent",
   "description": "Abstract subagent seam (ctx.subagents): named-provider registry for delegating to child agents",
-  "version": "0.1.5-rc.2",
+  "version": "0.1.6-alpha.2",
   "publishConfig": {
     "access": "public"
   },
@@ -54,36 +54,42 @@
   "license": "MIT",
   "dependencies": {
     "zod": "^4.4.3",
-    "@deepseek-ai/dsh-chunked-list": "^0.1.5-rc.2",
-    "@deepseek-ai/dsh-util-values": "^0.1.5-rc.2",
-    "@deepseek-ai/dsh-brand": "^0.1.5-rc.2"
+    "@deepseek-ai/dsh-brand": "^0.1.6-alpha.2",
+    "@deepseek-ai/dsh-chunked-list": "^0.1.6-alpha.2",
+    "@deepseek-ai/dsh-util-values": "^0.1.6-alpha.2",
+    "@deepseek-ai/schemastery": "^3.18.2"
   },
   "peerDependencies": {
     "@deepseek-ai/cordis": "^4.0.2",
-    "@deepseek-ai/dsh-agent": "^0.1.5-rc.2",
-    "@deepseek-ai/dsh-agent-presets": "^0.1.5-rc.2",
-    "@deepseek-ai/dsh-attachment": "^0.1.5-rc.2",
-    "@deepseek-ai/dsh-invariants": "^0.1.5-rc.2",
-    "@deepseek-ai/dsh-jobs": "^0.1.5-rc.2",
-    "@deepseek-ai/dsh-llm": "^0.1.5-rc.2",
-    "@deepseek-ai/dsh-sandbox": "^0.1.5-rc.2",
-    "@deepseek-ai/dsh-sandbox-policy": "^0.1.5-rc.2",
-    "@deepseek-ai/dsh-scope": "^0.1.5-rc.2",
-    "@deepseek-ai/dsh-session": "^0.1.5-rc.2",
-    "@deepseek-ai/dsh-session-persistence": "^0.1.5-rc.2",
-    "@deepseek-ai/dsh-session-projection": "^0.1.5-rc.2",
-    "@deepseek-ai/dsh-session-query": "^0.1.5-rc.2",
-    "@deepseek-ai/dsh-system-prompt": "^0.1.5-rc.2",
-    "@deepseek-ai/dsh-tools": "^0.1.5-rc.2",
-    "@deepseek-ai/dsh-typert-protocol": "^0.1.5-rc.2",
-    "@deepseek-ai/dsh-user-approval": "^0.1.5-rc.2",
-    "@deepseek-ai/dsh-util-time": "^0.1.5-rc.2",
-    "@deepseek-ai/dsh-session-projection-cache": "^0.1.5-rc.2"
+    "@deepseek-ai/dsh-agent": "^0.1.6-alpha.2",
+    "@deepseek-ai/dsh-agent-presets": "^0.1.6-alpha.2",
+    "@deepseek-ai/dsh-attachment": "^0.1.6-alpha.2",
+    "@deepseek-ai/dsh-invariants": "^0.1.6-alpha.2",
+    "@deepseek-ai/dsh-jobs": "^0.1.6-alpha.2",
+    "@deepseek-ai/dsh-llm": "^0.1.6-alpha.2",
+    "@deepseek-ai/dsh-sandbox": "^0.1.6-alpha.2",
+    "@deepseek-ai/dsh-sandbox-policy": "^0.1.6-alpha.2",
+    "@deepseek-ai/dsh-session": "^0.1.6-alpha.2",
+    "@deepseek-ai/dsh-session-persistence": "^0.1.6-alpha.2",
+    "@deepseek-ai/dsh-session-projection": "^0.1.6-alpha.2",
+    "@deepseek-ai/dsh-scope": "^0.1.6-alpha.2",
+    "@deepseek-ai/dsh-session-projection-cache": "^0.1.6-alpha.2",
+    "@deepseek-ai/dsh-system-prompt": "^0.1.6-alpha.2",
+    "@deepseek-ai/dsh-tools": "^0.1.6-alpha.2",
+    "@deepseek-ai/dsh-typert-protocol": "^0.1.6-alpha.2",
+    "@deepseek-ai/dsh-user-approval": "^0.1.6-alpha.2",
+    "@deepseek-ai/dsh-util-time": "^0.1.6-alpha.2",
+    "@deepseek-ai/dsh-permission-presets": "^0.1.6-alpha.2",
+    "@deepseek-ai/dsh-settings": "^0.1.6-alpha.2",
+    "@deepseek-ai/dsh-session-query": "^0.1.6-alpha.2"
   },
   "peerDependenciesMeta": {
     "@deepseek-ai/dsh-agent-presets": {
       "optional": true
     },
+    "@deepseek-ai/dsh-permission-presets": {
+      "optional": true
+    },
     "@deepseek-ai/dsh-sandbox": {
       "optional": true
     },
@@ -107,32 +113,37 @@
     },
     "@deepseek-ai/dsh-user-approval": {
       "optional": true
+    },
+    "@deepseek-ai/dsh-settings": {
+      "optional": true
     }
   },
   "devDependencies": {
     "@deepseek-ai/cordis": "^4.0.2",
-    "@deepseek-ai/dsh-agent": "^0.1.5-rc.2",
-    "@deepseek-ai/dsh-agent-presets": "^0.1.5-rc.2",
-    "@deepseek-ai/dsh-attachment": "^0.1.5-rc.2",
-    "@deepseek-ai/dsh-invariants": "^0.1.5-rc.2",
-    "@deepseek-ai/dsh-jobs": "^0.1.5-rc.2",
-    "@deepseek-ai/dsh-sandbox": "^0.1.5-rc.2",
-    "@deepseek-ai/dsh-sandbox-policy": "^0.1.5-rc.2",
-    "@deepseek-ai/dsh-llm": "^0.1.5-rc.2",
-    "@deepseek-ai/dsh-schedule": "^0.1.5-rc.2",
-    "@deepseek-ai/dsh-scope": "^0.1.5-rc.2",
-    "@deepseek-ai/dsh-session": "^0.1.5-rc.2",
-    "@deepseek-ai/dsh-session-persistence": "^0.1.5-rc.2",
-    "@deepseek-ai/dsh-session-projection": "^0.1.5-rc.2",
-    "@deepseek-ai/dsh-session-projection-cache": "^0.1.5-rc.2",
-    "@deepseek-ai/dsh-storage-domain": "^0.1.5-rc.2",
-    "@deepseek-ai/dsh-storage-json": "^0.1.5-rc.2",
-    "@deepseek-ai/dsh-system-prompt": "^0.1.5-rc.2",
-    "@deepseek-ai/dsh-session-query": "^0.1.5-rc.2",
-    "@deepseek-ai/dsh-tools": "^0.1.5-rc.2",
-    "@deepseek-ai/dsh-storage": "^0.1.5-rc.2",
-    "@deepseek-ai/dsh-typert-protocol": "^0.1.5-rc.2",
-    "@deepseek-ai/dsh-util-time": "^0.1.5-rc.2",
-    "@deepseek-ai/dsh-user-approval": "^0.1.5-rc.2"
+    "@deepseek-ai/dsh-agent": "^0.1.6-alpha.2",
+    "@deepseek-ai/dsh-attachment": "^0.1.6-alpha.2",
+    "@deepseek-ai/dsh-invariants": "^0.1.6-alpha.2",
+    "@deepseek-ai/dsh-jobs": "^0.1.6-alpha.2",
+    "@deepseek-ai/dsh-llm": "^0.1.6-alpha.2",
+    "@deepseek-ai/dsh-sandbox": "^0.1.6-alpha.2",
+    "@deepseek-ai/dsh-sandbox-policy": "^0.1.6-alpha.2",
+    "@deepseek-ai/dsh-agent-presets": "^0.1.6-alpha.2",
+    "@deepseek-ai/dsh-scope": "^0.1.6-alpha.2",
+    "@deepseek-ai/dsh-session-persistence": "^0.1.6-alpha.2",
+    "@deepseek-ai/dsh-session-projection": "^0.1.6-alpha.2",
+    "@deepseek-ai/dsh-session-projection-cache": "^0.1.6-alpha.2",
+    "@deepseek-ai/dsh-session-query": "^0.1.6-alpha.2",
+    "@deepseek-ai/dsh-storage": "^0.1.6-alpha.2",
+    "@deepseek-ai/dsh-storage-domain": "^0.1.6-alpha.2",
+    "@deepseek-ai/dsh-storage-json": "^0.1.6-alpha.2",
+    "@deepseek-ai/dsh-system-prompt": "^0.1.6-alpha.2",
+    "@deepseek-ai/dsh-tools": "^0.1.6-alpha.2",
+    "@deepseek-ai/dsh-typert-protocol": "^0.1.6-alpha.2",
+    "@deepseek-ai/dsh-user-approval": "^0.1.6-alpha.2",
+    "@deepseek-ai/dsh-util-time": "^0.1.6-alpha.2",
+    "@deepseek-ai/dsh-permission-presets": "^0.1.6-alpha.2",
+    "@deepseek-ai/dsh-settings": "^0.1.6-alpha.2",
+    "@deepseek-ai/dsh-session": "^0.1.6-alpha.2",
+    "@deepseek-ai/dsh-schedule": "^0.1.6-alpha.2"
   }
 }