@fishwithcat/dsh-subagent 0.2.2-alpha.2 → 0.2.2-alpha.3

package/lib/typert.remote-client.js

@@ -3,22 +3,16 @@ import { z } from 'zod'
 
 import { createTypertRemoteInfo } from '@deepseek-ai/dsh-typert-protocol/remote-info'
 
-let _deepseek_ai_dsh_subagent_subagents_interruptByParent_parameter_0$schema$value
-const _deepseek_ai_dsh_subagent_subagents_interruptByParent_parameter_0$schema = () => (_deepseek_ai_dsh_subagent_subagents_interruptByParent_parameter_0$schema$value ??= z.string())
-let _deepseek_ai_dsh_subagent_subagents_interruptByParent_parameter_1$schema$value
-const _deepseek_ai_dsh_subagent_subagents_interruptByParent_parameter_1$schema = () => (_deepseek_ai_dsh_subagent_subagents_interruptByParent_parameter_1$schema$value ??= z.string())
-let _deepseek_ai_dsh_subagent_subagents_interruptByParent_parameter_2$schema$value
-const _deepseek_ai_dsh_subagent_subagents_interruptByParent_parameter_2$schema = () => (_deepseek_ai_dsh_subagent_subagents_interruptByParent_parameter_2$schema$value ??= z.literal("continuable"))
-let _deepseek_ai_dsh_subagent_subagents_interruptByParent_result$schema$value
-const _deepseek_ai_dsh_subagent_subagents_interruptByParent_result$schema = () => (_deepseek_ai_dsh_subagent_subagents_interruptByParent_result$schema$value ??= z.object({
+let _deepseek_ai_dsh_subagent_subagents_interruptByUser_parameter_0$schema$value
+const _deepseek_ai_dsh_subagent_subagents_interruptByUser_parameter_0$schema = () => (_deepseek_ai_dsh_subagent_subagents_interruptByUser_parameter_0$schema$value ??= z.string())
+let _deepseek_ai_dsh_subagent_subagents_interruptByUser_result$schema$value
+const _deepseek_ai_dsh_subagent_subagents_interruptByUser_result$schema = () => (_deepseek_ai_dsh_subagent_subagents_interruptByUser_result$schema$value ??= z.object({
   'accepted': z.literal(true).readonly(),
 }))
 let _deepseek_ai_dsh_subagent_subagents_prompt_parameter_0$schema$value
 const _deepseek_ai_dsh_subagent_subagents_prompt_parameter_0$schema = () => (_deepseek_ai_dsh_subagent_subagents_prompt_parameter_0$schema$value ??= z.object({
   'requestId': z.string().readonly().describe('Identity persisted on the accepted message, minted before the call.'),
-  'parentSessionId': z.string().readonly(),
   'childSessionId': z.string().readonly(),
-  'mode': z.literal("continuable").readonly().describe('Required discriminator retained from the browser control address.'),
   'delivery': z.union([z.literal("queue"), z.literal("steer")]).readonly().describe('Whether this message queues a later turn or targets the nearest step.'),
   'content': z.array(z.union([z.object({
   'type': z.literal("text").readonly(),
@@ -35,18 +29,12 @@ let _deepseek_ai_dsh_subagent_subagents_prompt_result$schema$value
 const _deepseek_ai_dsh_subagent_subagents_prompt_result$schema = () => (_deepseek_ai_dsh_subagent_subagents_prompt_result$schema$value ??= z.object({
   'messageId': z.string().readonly(),
 }))
-let _deepseek_ai_dsh_subagent_subagents_interruptByParent_parameter_0_strict$schema$value
-const _deepseek_ai_dsh_subagent_subagents_interruptByParent_parameter_0_strict$schema = () => (_deepseek_ai_dsh_subagent_subagents_interruptByParent_parameter_0_strict$schema$value ??= z.string())
-let _deepseek_ai_dsh_subagent_subagents_interruptByParent_parameter_1_strict$schema$value
-const _deepseek_ai_dsh_subagent_subagents_interruptByParent_parameter_1_strict$schema = () => (_deepseek_ai_dsh_subagent_subagents_interruptByParent_parameter_1_strict$schema$value ??= z.string())
-let _deepseek_ai_dsh_subagent_subagents_interruptByParent_parameter_2_strict$schema$value
-const _deepseek_ai_dsh_subagent_subagents_interruptByParent_parameter_2_strict$schema = () => (_deepseek_ai_dsh_subagent_subagents_interruptByParent_parameter_2_strict$schema$value ??= z.literal("continuable"))
+let _deepseek_ai_dsh_subagent_subagents_interruptByUser_parameter_0_strict$schema$value
+const _deepseek_ai_dsh_subagent_subagents_interruptByUser_parameter_0_strict$schema = () => (_deepseek_ai_dsh_subagent_subagents_interruptByUser_parameter_0_strict$schema$value ??= z.string())
 let _deepseek_ai_dsh_subagent_subagents_prompt_parameter_0_strict$schema$value
 const _deepseek_ai_dsh_subagent_subagents_prompt_parameter_0_strict$schema = () => (_deepseek_ai_dsh_subagent_subagents_prompt_parameter_0_strict$schema$value ??= z.strictObject({
   'requestId': z.string().readonly().describe('Identity persisted on the accepted message, minted before the call.'),
-  'parentSessionId': z.string().readonly(),
   'childSessionId': z.string().readonly(),
-  'mode': z.literal("continuable").readonly().describe('Required discriminator retained from the browser control address.'),
   'delivery': z.union([z.literal("queue"), z.literal("steer")]).readonly().describe('Whether this message queues a later turn or targets the nearest step.'),
   'content': z.array(z.union([z.strictObject({
   'type': z.literal("text").readonly(),
@@ -63,9 +51,9 @@ const _deepseek_ai_dsh_subagent_subagents_prompt_parameter_0_strict$schema = ()
 export const TYPERT_REMOTE = createTypertRemoteInfo({
   package: '@fishwithcat/dsh-subagent',
   methods: {
-    'subagents/interruptByParent': {
+    'subagents/interruptByUser': {
       service: 'subagents',
-      description: 'Remote face of {@link interrupt} under one durable parent address. No catalog, history, persistence, or parent Agent lookup runs: the core primitive alone authorizes the address against the live Activation, which is what keeps a live child interruptible while its parent Agent is offline. Absent, idle, and already-completed targets are accepted no-ops there.',
+      description: 'Remote face of {@link interrupt}, authorized on the target Session by the Gateway. No catalog, history, persistence, or parent Agent lookup runs. Absent, idle, and already-completed targets are accepted no-ops there.',
       invocation: { kind: 'direct' },
       parameters: [
         {
@@ -75,80 +63,46 @@ export const TYPERT_REMOTE = createTypertRemoteInfo({
           codec: {
             mode: 'strict',
             typeSymbol: '@deepseek-ai/dsh-session/types#SessionId',
-            create: _deepseek_ai_dsh_subagent_subagents_interruptByParent_parameter_0$schema,
+            create: _deepseek_ai_dsh_subagent_subagents_interruptByUser_parameter_0$schema,
             jsonSchema: {"type":"string"},
           },
           strictCodec: {
             mode: 'strict',
             typeSymbol: '@deepseek-ai/dsh-session/types#SessionId',
-            create: _deepseek_ai_dsh_subagent_subagents_interruptByParent_parameter_0_strict$schema,
+            create: _deepseek_ai_dsh_subagent_subagents_interruptByUser_parameter_0_strict$schema,
             jsonSchema: {"type":"string"},
           },
         },
-        {
-          name: 'parentSessionId',
-          description: 'durable direct parent whose authority is claimed.',
-          source: 'json',
-          codec: {
-            mode: 'strict',
-            typeSymbol: '@deepseek-ai/dsh-session/types#SessionId',
-            create: _deepseek_ai_dsh_subagent_subagents_interruptByParent_parameter_1$schema,
-            jsonSchema: {"type":"string"},
-          },
-          strictCodec: {
-            mode: 'strict',
-            typeSymbol: '@deepseek-ai/dsh-session/types#SessionId',
-            create: _deepseek_ai_dsh_subagent_subagents_interruptByParent_parameter_1_strict$schema,
-            jsonSchema: {"type":"string"},
-          },
-        },
-        {
-          name: 'mode',
-          description: 'required continuable-address discriminator.',
-          source: 'json',
-          codec: {
-            mode: 'strict',
-            typeSymbol: '@deepseek-ai/dsh-subagent#subagents/interruptByParent:mode',
-            create: _deepseek_ai_dsh_subagent_subagents_interruptByParent_parameter_2$schema,
-            jsonSchema: {"type":"string","const":"continuable"},
-          },
-          strictCodec: {
-            mode: 'strict',
-            typeSymbol: '@deepseek-ai/dsh-subagent#subagents/interruptByParent:mode',
-            create: _deepseek_ai_dsh_subagent_subagents_interruptByParent_parameter_2_strict$schema,
-            jsonSchema: {"type":"string","const":"continuable"},
-          },
-        },
       ],
       result: {
         mode: 'strict',
         typeSymbol: '@deepseek-ai/dsh-subagent/client#SubagentInterruptReceipt',
-        create: _deepseek_ai_dsh_subagent_subagents_interruptByParent_result$schema,
+        create: _deepseek_ai_dsh_subagent_subagents_interruptByUser_result$schema,
         description: 'acknowledgement that the cancel signal was admitted, not that the target is quiescent.',
         jsonSchema: {"type":"object","properties":{"accepted":{"type":"boolean","const":true}},"required":["accepted"],"additionalProperties":true},
       },
-      sourceLocation: {"file":"packages/subagent/subagent/src/index.ts","line":529,"column":3},
+      sourceLocation: {"file":"packages/subagent/subagent/src/index.ts","line":467,"column":3},
     },
     'subagents/prompt': {
       service: 'subagents',
-      description: 'Deliver one browser-authored message to a continuable child through the exact live direct parent, retaining the caller-minted request identity and validated browser zone on the accepted message. Success identifies the message the child\'s inbox accepted; later execution is independent of this call. Queue delivery targets a later turn; steer delivery targets the 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`.',
+      description: 'Deliver one browser-authored message to a continuable child through its live subagent tree root, retaining the caller-minted request identity and validated browser zone on the accepted message. Success identifies the message the child\'s inbox accepted; later execution is independent of this call. Queue delivery targets a later turn; steer delivery targets the 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`. Access is checked on the target Session before attachment admission or restoration.',
       invocation: { kind: 'direct' },
       parameters: [
         {
           name: 'request',
-          description: 'durable address, delivery, minted identity, content, and optional browser zone.',
+          description: 'target id, delivery, minted identity, content, and optional browser zone.',
           source: 'json',
           codec: {
             mode: 'strict',
             typeSymbol: '@deepseek-ai/dsh-subagent/client#SubagentPromptRequest',
             create: _deepseek_ai_dsh_subagent_subagents_prompt_parameter_0$schema,
-            jsonSchema: {"type":"object","properties":{"requestId":{"type":"string","description":"Identity persisted on the accepted message, minted before the call."},"parentSessionId":{"type":"string"},"childSessionId":{"type":"string"},"mode":{"type":"string","const":"continuable","description":"Required discriminator retained from the browser control address."},"delivery":{"type":"string","enum":["queue","steer"],"description":"Whether this message queues a later turn or targets the nearest step."},"content":{"type":"array","items":{"oneOf":[{"type":"object","properties":{"type":{"type":"string","const":"text"},"text":{"type":"string"}},"required":["type","text"],"additionalProperties":true},{"type":"object","properties":{"type":{"type":"string","const":"image"},"mediaType":{"type":"string","enum":["image/png","image/jpeg","image/webp","image/gif"]},"data":{"type":"string"},"name":{"type":"string"}},"required":["type","mediaType","data"],"additionalProperties":true}]},"description":"Browser prompt parts delivered as the child's user message. The Host admits and persists image parts before delivery, so the wire never carries a durable attachment reference the caller could fabricate."},"clientTimeZone":{"type":"string","description":"Optional browser zone sampled for this exact human prompt."}},"required":["requestId","parentSessionId","childSessionId","mode","delivery","content"],"additionalProperties":true},
+            jsonSchema: {"type":"object","properties":{"requestId":{"type":"string","description":"Identity persisted on the accepted message, minted before the call."},"childSessionId":{"type":"string"},"delivery":{"type":"string","enum":["queue","steer"],"description":"Whether this message queues a later turn or targets the nearest step."},"content":{"type":"array","items":{"oneOf":[{"type":"object","properties":{"type":{"type":"string","const":"text"},"text":{"type":"string"}},"required":["type","text"],"additionalProperties":true},{"type":"object","properties":{"type":{"type":"string","const":"image"},"mediaType":{"type":"string","enum":["image/png","image/jpeg","image/webp","image/gif"]},"data":{"type":"string"},"name":{"type":"string"}},"required":["type","mediaType","data"],"additionalProperties":true}]},"description":"Browser prompt parts delivered as the child's user message. The Host admits and persists image parts before delivery, so the wire never carries a durable attachment reference the caller could fabricate."},"clientTimeZone":{"type":"string","description":"Optional browser zone sampled for this exact human prompt."}},"required":["requestId","childSessionId","delivery","content"],"additionalProperties":true},
           },
           strictCodec: {
             mode: 'strict',
             typeSymbol: '@deepseek-ai/dsh-subagent/client#SubagentPromptRequest',
             create: _deepseek_ai_dsh_subagent_subagents_prompt_parameter_0_strict$schema,
-            jsonSchema: {"type":"object","properties":{"requestId":{"type":"string","description":"Identity persisted on the accepted message, minted before the call."},"parentSessionId":{"type":"string"},"childSessionId":{"type":"string"},"mode":{"type":"string","const":"continuable","description":"Required discriminator retained from the browser control address."},"delivery":{"type":"string","enum":["queue","steer"],"description":"Whether this message queues a later turn or targets the nearest step."},"content":{"type":"array","items":{"oneOf":[{"type":"object","properties":{"type":{"type":"string","const":"text"},"text":{"type":"string"}},"required":["type","text"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","const":"image"},"mediaType":{"type":"string","enum":["image/png","image/jpeg","image/webp","image/gif"]},"data":{"type":"string"},"name":{"type":"string"}},"required":["type","mediaType","data"],"additionalProperties":false}]},"description":"Browser prompt parts delivered as the child's user message. The Host admits and persists image parts before delivery, so the wire never carries a durable attachment reference the caller could fabricate."},"clientTimeZone":{"type":"string","description":"Optional browser zone sampled for this exact human prompt."}},"required":["requestId","parentSessionId","childSessionId","mode","delivery","content"],"additionalProperties":false},
+            jsonSchema: {"type":"object","properties":{"requestId":{"type":"string","description":"Identity persisted on the accepted message, minted before the call."},"childSessionId":{"type":"string"},"delivery":{"type":"string","enum":["queue","steer"],"description":"Whether this message queues a later turn or targets the nearest step."},"content":{"type":"array","items":{"oneOf":[{"type":"object","properties":{"type":{"type":"string","const":"text"},"text":{"type":"string"}},"required":["type","text"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","const":"image"},"mediaType":{"type":"string","enum":["image/png","image/jpeg","image/webp","image/gif"]},"data":{"type":"string"},"name":{"type":"string"}},"required":["type","mediaType","data"],"additionalProperties":false}]},"description":"Browser prompt parts delivered as the child's user message. The Host admits and persists image parts before delivery, so the wire never carries a durable attachment reference the caller could fabricate."},"clientTimeZone":{"type":"string","description":"Optional browser zone sampled for this exact human prompt."}},"required":["requestId","childSessionId","delivery","content"],"additionalProperties":false},
           },
         },
       ],
@@ -160,7 +114,7 @@ export const TYPERT_REMOTE = createTypertRemoteInfo({
         description: 'the accepted message\'s inbox identity.',
         jsonSchema: {"type":"object","properties":{"messageId":{"type":"string"}},"required":["messageId"],"additionalProperties":true},
       },
-      sourceLocation: {"file":"packages/subagent/subagent/src/index.ts","line":460,"column":9},
+      sourceLocation: {"file":"packages/subagent/subagent/src/index.ts","line":414,"column":9},
     },
   },
 }, z)

package/lib/types/activation.d.ts

@@ -3,10 +3,9 @@
  */
 import type { Agent, AgentHandle } from '@deepseek-ai/dsh-agent';
 import type { SessionId, SessionLogOffset } from '@deepseek-ai/dsh-session';
-import type { ActivationObserver } from './lifecycle.ts';
 import type { StructuredAttachment } from './structured.ts';
-import type { SubagentResult, SubagentRun } from './types.ts';
-/** Process-local slots shared through uninterrupted continuable parent links. */
+import type { SubagentResult, SubagentRun, SubagentRunId } from './types.ts';
+/** Process-local capacity shared by every member of a subagent tree. */
 export declare class ActivationPool {
     private readonly slots;
     /**
@@ -21,37 +20,28 @@ export declare class ActivationPool {
  * The manager owns admission, execution handles, and resource release.
  */
 interface ActivationBase {
-    /** Shared capacity for this Activation and all its managed descendants. */
-    readonly pool: ActivationPool;
     /** Return this epoch's slot after its handle has finished disposal. */
     readonly releaseSlot: () => void;
     /** The durable child this Activation is an epoch of. */
     readonly childId: SessionId;
-    readonly parent: Agent;
+    /** Unique identity shared by this residency epoch's start/end event pair. */
+    readonly runId: SubagentRunId;
+    /** Provider recorded at creation, retained across cold resumes. */
+    readonly provider: string;
+    /** Exact live subagent tree root owning this instance and its shared capacity. */
+    readonly root: Agent;
+    /** Verified creation ancestors, from subagent tree root to direct creator. */
+    readonly ancestors: readonly SessionId[];
     readonly delivery: 'parent' | 'caller';
     readonly result: PromiseWithResolvers<SubagentResult>;
     /** Published synchronously before teardown; subsequent callers share this transaction. */
     closing: Promise<void> | undefined;
     /**
-     * Exact live Agent ancestry observed when this Activation materialized.
-     * Weak membership preserves host-scope identity across an intermediate
-     * ancestor leaving the registry without retaining that ancestor's runtime.
+     * Whether local input was accepted or external startup completed, including
+     * any required catalog publication. Until then, teardown owes the parent no
+     * settlement notice, even if this epoch's start event was already published.
      */
-    readonly ancestry: WeakSet<Agent>;
-    /**
-     * Session ids of the child Activations this one owns. Because one Session has
-     * at most one live Activation, the id identifies the live child without
-     * another runtime-incarnation reference. Non-empty blocks settlement.
-     */
-    readonly ownedChildren: Set<SessionId>;
-    /** The lifecycle observer that emits this epoch's start and terminal edges. */
-    readonly observer: ActivationObserver;
-    /**
-     * Whether any delivery to this child was ever accepted. A materialization
-     * rolled back before its first acceptance is a child the caller was told does
-     * not exist, so its teardown owes the parent no settlement account.
-     */
-    announced: boolean;
+    accepted: boolean;
 }
 /** Resources retained only for the selected execution kind. */
 export type ActivationResource = {
@@ -61,7 +51,7 @@ export type ActivationResource = {
     readonly structured: StructuredAttachment | undefined;
     /** Latest live failure not superseded by a later committed turn ending. */
     failureAt: SessionLogOffset | undefined;
-    /** Renewed when local settlement must recheck input or owned children. */
+    /** Renewed when local settlement must recheck input. */
     poke: PromiseWithResolvers<void>;
     /**
      * Whether this child's settlement notice omits its closing text: true while

package/lib/types/activation.js

@@ -5,7 +5,7 @@ import { assertNever } from '@deepseek-ai/dsh-util-values';
 import { finalAssistantOutput } from "./assistant-output.js";
 import { epochStopReason } from "./lifecycle.js";
 import { SubagentError } from "./error.js";
-/** Process-local slots shared through uninterrupted continuable parent links. */
+/** Process-local capacity shared by every member of a subagent tree. */
 export class ActivationPool {
     slots = new Set();
     /**

package/lib/types/archive-admission.d.ts

@@ -1,16 +1,23 @@
 /**
  * The `subagent` family of the Workspace registry's archive admission: which
  * subagent descendants of a Session are still inside a turn, and how they
- * stop when the Session is archived with its work.
+ * stop when the Session is archived with its work. Archived ancestors also
+ * block later model steps, including when their Sessions have been released.
  *
  * @module @deepseek-ai/dsh-subagent
  */
 import type { Context } from '@deepseek-ai/cordis';
+import type { Agent } from '@deepseek-ai/dsh-agent';
+import type { Session, SessionId } from '@deepseek-ai/dsh-session';
+import type { SubagentIdentityProjection } from './projection-types.ts';
 /**
  * Answer `workspace/session-activity` with the running subagent descendants of
  * the asked Session, and `workspace/session-stop` by cancelling each of them
- * as their parent would. Both listeners live as long as `ctx`'s fiber.
- * @param ctx - context carrying the Agent registry; the Session query service is optional and only supplies labels.
+ * as their parent would. Reject subsequent steps beneath archived ancestors.
+ * All listeners live as long as `ctx`'s fiber.
+ * @param ctx - context carrying the Agent registry.
+ * @param residentAncestors - verified creation ancestors for an exact managed Agent, absent before publication or for unmanaged Agents.
+ * @param identityOf - ready service-owned descriptor identity reader; absent or invalid descriptors yield no identity.
  */
-export declare function installSubagentArchiveAdmission(ctx: Context): void;
+export declare function installSubagentArchiveAdmission(ctx: Context, residentAncestors: (agent: Agent) => readonly SessionId[] | undefined, identityOf: (session: Session) => SubagentIdentityProjection | undefined): void;
 //# sourceMappingURL=archive-admission.d.ts.map

package/lib/types/archive-admission.js

@@ -1,80 +1,34 @@
 /**
  * The `subagent` family of the Workspace registry's archive admission: which
  * subagent descendants of a Session are still inside a turn, and how they
- * stop when the Session is archived with its work.
+ * stop when the Session is archived with its work. Archived ancestors also
+ * block later model steps, including when their Sessions have been released.
  *
  * @module @deepseek-ai/dsh-subagent
  */
-var __addDisposableResource = (this && this.__addDisposableResource) || function (env, value, async) {
-    if (value !== null && value !== void 0) {
-        if (typeof value !== "object" && typeof value !== "function") throw new TypeError("Object expected.");
-        var dispose, inner;
-        if (async) {
-            if (!Symbol.asyncDispose) throw new TypeError("Symbol.asyncDispose is not defined.");
-            dispose = value[Symbol.asyncDispose];
-        }
-        if (dispose === void 0) {
-            if (!Symbol.dispose) throw new TypeError("Symbol.dispose is not defined.");
-            dispose = value[Symbol.dispose];
-            if (async) inner = dispose;
-        }
-        if (typeof dispose !== "function") throw new TypeError("Object not disposable.");
-        if (inner) dispose = function() { try { inner.call(this); } catch (e) { return Promise.reject(e); } };
-        env.stack.push({ value: value, dispose: dispose, async: async });
-    }
-    else if (async) {
-        env.stack.push({ async: true });
-    }
-    return value;
-};
-var __disposeResources = (this && this.__disposeResources) || (function (SuppressedError) {
-    return function (env) {
-        function fail(e) {
-            env.error = env.hasError ? new SuppressedError(e, env.error, "An error was suppressed during disposal.") : e;
-            env.hasError = true;
-        }
-        var r, s = 0;
-        function next() {
-            while (r = env.stack.pop()) {
-                try {
-                    if (!r.async && s === 1) return s = 0, env.stack.push(r), Promise.resolve().then(next);
-                    if (r.dispose) {
-                        var result = r.dispose.call(r.value);
-                        if (r.async) return s |= 2, Promise.resolve(result).then(next, function(e) { fail(e); return next(); });
-                    }
-                    else s |= 1;
-                }
-                catch (e) {
-                    fail(e);
-                }
-            }
-            if (s === 1) return env.hasError ? Promise.reject(env.error) : Promise.resolve();
-            if (env.hasError) throw env.error;
-        }
-        return next();
-    };
-})(typeof SuppressedError === "function" ? SuppressedError : function (error, suppressed, message) {
-    var e = new Error(message);
-    return e.name = "SuppressedError", e.error = error, e.suppressed = suppressed, e;
-});
-import { foldSubagentDescriptor } from "./descriptor.js";
 /**
  * Answer `workspace/session-activity` with the running subagent descendants of
  * the asked Session, and `workspace/session-stop` by cancelling each of them
- * as their parent would. Both listeners live as long as `ctx`'s fiber.
- * @param ctx - context carrying the Agent registry; the Session query service is optional and only supplies labels.
+ * as their parent would. Reject subsequent steps beneath archived ancestors.
+ * All listeners live as long as `ctx`'s fiber.
+ * @param ctx - context carrying the Agent registry.
+ * @param residentAncestors - verified creation ancestors for an exact managed Agent, absent before publication or for unmanaged Agents.
+ * @param identityOf - ready service-owned descriptor identity reader; absent or invalid descriptors yield no identity.
  */
-export function installSubagentArchiveAdmission(ctx) {
+export function installSubagentArchiveAdmission(ctx, residentAncestors, identityOf) {
+    const ancestorsOf = (agent) => residentAncestors(agent) ?? headerAncestors(ctx, agent);
+    const runningDescendants = (sessionId) => ctx.agents.list()
+        .filter(agent => agent.status === 'running' && ancestorsOf(agent).includes(sessionId));
     ctx.on('workspace/session-activity', async ({ sessionId }, next) => {
-        const running = runningDescendants(ctx, sessionId);
+        const running = runningDescendants(sessionId);
         const rest = await next();
         if (running.length === 0)
             return rest;
-        const own = { kind: 'subagent', items: await Promise.all(running.map(child => describe(ctx, child))) };
+        const own = { kind: 'subagent', items: running.map(child => describe(child, identityOf(child.session))) };
         return [own, ...rest];
     });
     ctx.on('workspace/session-stop', ({ sessionId }) => {
-        for (const child of runningDescendants(ctx, sessionId)) {
+        for (const child of runningDescendants(sessionId)) {
             try {
                 child.cancel({ kind: 'parent' });
             }
@@ -84,68 +38,38 @@ export function installSubagentArchiveAdmission(ctx) {
             }
         }
     });
+    ctx.on('agent/pre-step', ({ agent }, next) => {
+        const archived = ctx.get('workspaceRegistry')?.archivedSessionIds;
+        return archived !== undefined && ancestorsOf(agent).some(id => archived.includes(id))
+            ? Promise.resolve({ kind: 'reject' })
+            : next();
+    });
 }
 /**
- * Live subagent descendants inside a turn, by durable lineage: a child whose
- * header names its parent and carries the subagent origin this package
- * records, at any depth. A fork shares the lineage field without the origin
- * and is an independent conversation, so it never holds its source. Lineage
- * is read as data, so a damaged header chain that loops is visited once.
+ * Header-only ancestry for Agents without a published Activation. Include an
+ * offline direct creator; ordinary forks stop the chain and cycles terminate.
  */
-function runningDescendants(ctx, rootId) {
-    const childrenOf = new Map();
-    for (const agent of ctx.agents.list()) {
-        const { parentSession, origin } = agent.session.header;
-        if (parentSession === undefined || origin !== 'subagent')
-            continue;
-        const siblings = childrenOf.get(parentSession) ?? [];
-        siblings.push(agent);
-        childrenOf.set(parentSession, siblings);
-    }
-    const running = [];
-    const pending = [rootId];
-    const visited = new Set();
-    while (pending.length > 0) {
-        const parentId = pending.shift();
-        if (visited.has(parentId))
-            continue;
+function headerAncestors(ctx, agent) {
+    const ancestors = [];
+    const visited = new Set([agent.id]);
+    let header = agent.session.header;
+    while (header.origin === 'subagent' && header.parentSession !== undefined && !visited.has(header.parentSession)) {
+        const parentId = header.parentSession;
+        ancestors.push(parentId);
         visited.add(parentId);
-        for (const child of childrenOf.get(parentId) ?? []) {
-            if (child.status === 'running')
-                running.push(child);
-            pending.push(child.id);
-        }
+        const parent = ctx.agents.get(parentId)?.session;
+        if (parent === undefined)
+            break;
+        header = parent.header;
     }
-    return running;
+    return ancestors;
 }
 /**
- * The child's activity item: its id, plus the durable creation label its
- * descriptor carries, read through a live Session observation. Without the
- * Session query service, or with a descriptor that is absent or unreadable,
- * the item names the child by id alone.
+ * Report the child's current projected label only when its descriptor belongs
+ * to the child's own log; inherited, absent, or invalid identities yield the id alone.
  */
-async function describe(ctx, child) {
-    const query = ctx.get('sessionQuery');
-    if (query === undefined)
-        return { id: child.id };
-    try {
-        const env_1 = { stack: [], error: void 0, hasError: false };
-        try {
-            const observation = __addDisposableResource(env_1, await query.observeSession(child.id, { projectionMode: 'none' }), false);
-            const label = foldSubagentDescriptor(observation.events.slice(observation.inheritedEventCount))?.label;
-            return label === undefined ? { id: child.id } : { id: child.id, label };
-        }
-        catch (e_1) {
-            env_1.error = e_1;
-            env_1.hasError = true;
-        }
-        finally {
-            __disposeResources(env_1);
-        }
-    }
-    catch {
-        // A damaged descriptor is data damage in the child; the report still names the child.
-        return { id: child.id };
-    }
+function describe(child, identity) {
+    const label = identity !== undefined && child.session.isOwnSeq(identity.seq) ? identity.label : undefined;
+    return label === undefined ? { id: child.id } : { id: child.id, label };
 }
 //# sourceMappingURL=archive-admission.js.map

package/lib/types/child-agent.d.ts

@@ -8,7 +8,7 @@
 import type { Context } from '@deepseek-ai/cordis';
 import type { Agent, AgentOptions, CreateAgentOptions } from '@deepseek-ai/dsh-agent';
 import type { SandboxMode } from '@deepseek-ai/dsh-sandbox';
-import type { Session, SessionId } from '@deepseek-ai/dsh-session';
+import type { Session } from '@deepseek-ai/dsh-session';
 import type { ToolRestriction } from '@deepseek-ai/dsh-tools';
 import type { ApprovalPolicy } from '@deepseek-ai/dsh-user-approval';
 /** Thrown when starting a child would exceed the requested depth cap. */
@@ -66,7 +66,7 @@ export declare function resolveChildAgentOptions(parent: Agent, requested: Agent
 export declare function childSessionMeta(parent: Agent, childDepth: number, isSeeded: boolean, selectedPreset?: string): NonNullable<CreateAgentOptions['meta']>;
 /** The scoped composition a child agent's creation window applies. */
 export interface ChildComposition {
-    /** Independently mounted preset; omission shares the parent's standing generation. */
+    /** Preset to mount; omission shares a supplied creator or uses host composition. */
     readonly agentPreset?: string | undefined;
     /** Historical descriptor persona reapplied only during cold resume. */
     readonly persona?: string | undefined;
@@ -88,15 +88,16 @@ export declare const SUBAGENT_DELEGATION_CONTEXT: string;
 export declare const SUBAGENT_DELEGATION_INTERACTIVE_CONTEXT: string;
 /**
  * Compose a child before publication and restore historical descriptor overrides.
- * Explicit selection mounts the named preset; omission synchronously joins the
- * parent's current generation. Registrations belong to the child's scope.
+ * Explicit selection mounts the named preset. Omission joins a supplied creator's
+ * current generation; a restored child without a saved preset uses host composition.
+ * Registrations belong to the child's scope.
  * @param childCtx - the child agent's scoped creation context.
- * @param parent - the delegating parent used when no preset is selected.
+ * @param parent - creator for fresh delegation; absent during target-only restoration.
  * @param composition - independent preset and any overrides read from a historical descriptor.
  * @param approvalPolicy - the child's effective approval policy, selecting its delegation statement.
  * @returns A promise when mounting an independent preset; otherwise completes synchronously.
  */
-export declare function applyChildComposition(childCtx: Context, parent: Agent, composition: ChildComposition, approvalPolicy: ApprovalPolicy | undefined): void | Promise<void>;
+export declare function applyChildComposition(childCtx: Context, parent: Agent | undefined, composition: ChildComposition, approvalPolicy: ApprovalPolicy | undefined): void | Promise<void>;
 /** How a delegated child's approval policy is seeded at creation. */
 export type DelegatedApprovalPolicy = 'never' | 'inherit';
 /** Policy seeded onto a child session's log at the delegation boundary. */
@@ -141,15 +142,4 @@ export declare function captureDelegatedPolicyOverrides(parent: Agent, delegated
  * @param overrides - the policy captured at delegation.
  */
 export declare function appendDelegatedPolicyOverrides(childSession: Session, overrides: DelegatedPolicyOverrides): void;
-/** Identity and lineage inputs shared by every in-process child creation. */
-export interface ChildCreateInputs {
-    /** The child's reserved session id. */
-    readonly sessionId: SessionId;
-    /** The delegating parent agent. */
-    readonly parent: Agent;
-    /** The resolved delegation depth. */
-    readonly childDepth: number;
-    /** How many leading seed events came from the parent's log. */
-    readonly lineageSeedLength: number;
-}
 //# sourceMappingURL=child-agent.d.ts.map

package/lib/types/child-agent.js

@@ -140,10 +140,11 @@ export const SUBAGENT_DELEGATION_INTERACTIVE_CONTEXT = 'You are a delegated suba
     + 'state the limitation in your reply so the delegating agent can handle it.';
 /**
  * Compose a child before publication and restore historical descriptor overrides.
- * Explicit selection mounts the named preset; omission synchronously joins the
- * parent's current generation. Registrations belong to the child's scope.
+ * Explicit selection mounts the named preset. Omission joins a supplied creator's
+ * current generation; a restored child without a saved preset uses host composition.
+ * Registrations belong to the child's scope.
  * @param childCtx - the child agent's scoped creation context.
- * @param parent - the delegating parent used when no preset is selected.
+ * @param parent - creator for fresh delegation; absent during target-only restoration.
  * @param composition - independent preset and any overrides read from a historical descriptor.
  * @param approvalPolicy - the child's effective approval policy, selecting its delegation statement.
  * @returns A promise when mounting an independent preset; otherwise completes synchronously.
@@ -158,7 +159,8 @@ export function applyChildComposition(childCtx, parent, composition, approvalPol
             applyChildOverrides(childCtx, composition, approvalPolicy);
         });
     }
-    childCtx.get('agentPresets')?.composeFrom(childCtx, parent.ctx);
+    if (parent !== undefined)
+        childCtx.get('agentPresets')?.composeFrom(childCtx, parent.ctx);
     applyChildOverrides(childCtx, composition, approvalPolicy);
 }
 function applyChildOverrides(childCtx, composition, approvalPolicy) {

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

@@ -29,6 +29,8 @@ export interface SubagentSettledMessageSource {
     readonly form: 'notice';
     /** One-line account of how the child ended. */
     readonly summary: string;
+    /** Exact execution stop reason; absent on historical notices. Writers always include it. */
+    readonly stopReason?: SubagentResult['stopReason'];
     /** Session id of the child that settled. */
     readonly senderSessionId: SessionId;
 }
@@ -39,26 +41,25 @@ declare module '@deepseek-ai/dsh-llm' {
     }
 }
 /**
- * Build the model-visible and durable representation of one adjacent-Agent message.
+ * Build the model-visible and durable representation of one Agent message.
  * @param sender - exact live Agent that authored the message.
  * @param content - model-visible message blocks supplied by the sender.
  * @returns the durable user-message representation delivered to the recipient.
  */
 export declare function createAgentMessage(sender: Agent, content: ContentBlock[]): ReturnType<typeof createUserMessage>;
 /**
- * Append adjacent-Agent return guidance to a continuable child's initial task.
- * @param parentId - durable parent session id named in the guidance.
+ * Append automatic result-delivery guidance to a parent-delivered child's initial task.
  * @param prompt - initial model-visible task blocks.
- * @returns task blocks followed by the continuable return guidance.
+ * @returns task blocks followed by the result-delivery guidance.
  */
-export declare function withContinuableReturnGuidance(parentId: SessionId, prompt: ContentBlock[]): ContentBlock[];
+export declare function withResultDeliveryGuidance(prompt: ContentBlock[]): ContentBlock[];
 /**
  * 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.
  * @param continuable - whether the child can accept another task.
- * @param omitClosingText - replace the closing text with a note that the child's
- *   last message to the parent already carries it.
+ * @param omitClosingText - replace the closing text when the child's last action
+ *   was a message to its direct parent.
  * @returns the durable user-message representation delivered to the parent.
  */
 export declare function createSettlementMessage(childId: SessionId, terminal: SubagentResult, continuable?: boolean, omitClosingText?: boolean): ReturnType<typeof createUserMessage>;