@deepseek-ai/dsh-subagent 0.1.2-alpha.2 → 0.1.2-alpha.4

package/lib/types/list-children.js

@@ -4,9 +4,10 @@
  * corpus; each child's mode/label is the registered `subagent` projection
  * unit's value, resolved
  * down a three-rung ladder: the registry's watermark cache for a live child,
- * a durable projection-cache row when it serves an own-suffix identity (the
- * seq gate), and one shared Session observation otherwise, validated against
- * the enumerated lifecycle. The projection fold is the single classification
+ * an unseeded durable projection-cache row, and one shared Session observation
+ * otherwise. A seeded header deliberately lacks its exact inherited cut, so
+ * it takes the body-bearing observation path before classifying an identity.
+ * The projection fold is the single classification
  * authority — this module parses no descriptor
  * itself. Absent persistence, enumeration is live-only: a cold child is
  * unreachable for resume anyway, so its absence is capability absence, not an
@@ -67,6 +68,7 @@ var __disposeResources = (this && this.__disposeResources) || (function (Suppres
     var e = new Error(message);
     return e.name = "SuppressedError", e.error = error, e.suppressed = suppressed, e;
 });
+import { SessionLogOffset } from '@deepseek-ai/dsh-session';
 import { SubagentError } from "./error.js";
 /**
  * Concurrent cold observations per explicit catalog listing. Current Session
@@ -79,8 +81,8 @@ const COLD_READ_CONCURRENCY = 4;
  * live-preferred merge of `ctx.sessions` and optional session persistence,
  * serving each identity from the `subagent` projection unit: the registry's
  * watermark snapshot for a live child; for a cold one, a durable
- * projection-cache read when it serves an own-suffix identity (the seq gate),
- * else one bounded-concurrency shared Session observation.
+ * projection-cache read for an unseeded lifecycle, else one bounded-concurrency
+ * shared Session observation carrying the exact inherited cut.
  * @see SubagentRuntime.listChildren for the public cancellation and failure contract.
  * @param ctx - context carrying the session store, the projection registry,
  *   optional persistence, and the optional projection cache.
@@ -203,7 +205,7 @@ async function resolveCandidateRows(candidates, listing, signal) {
         // The unit's serializable no-value sentinel is `null`; `undefined` can
         // only mean the key was dropped at a JSON boundary. Both are no value.
         if (identity === undefined || identity === null
-            || identity.seq < (candidate.header.seedLength ?? 0))
+            || !candidate.live.isOwnSeq(identity.seq))
             return;
         rows[index] = childRow(childId, identity, 'running', subagentParents.has(childId));
     });
@@ -261,9 +263,8 @@ function compareCorpusRecords(a, b) {
     return a.header.createdAt - b.header.createdAt || a.header.id.localeCompare(b.header.id);
 }
 /**
- * Resolve one cold candidate down the remaining ladder: a durable
- * projection-cache row when it serves an own-suffix identity (the seq gate),
- * otherwise one shared Session observation. An absent or transiently failed
+ * Resolve one cold candidate down the remaining ladder: an unseeded durable
+ * projection-cache row, otherwise one shared Session observation. An absent or transiently failed
  * observation is one `unavailable` row retried on the next listing; an observation
  * source naming another lifecycle, and a
  * settled log the fold cannot identify — or that makes any registered unit
@@ -273,10 +274,14 @@ async function resolveColdIdentity(query, cache, header, hasChildren, signal) {
     const env_1 = { stack: [], error: void 0, hasError: false };
     try {
         const childId = header.id;
-        if (cache !== undefined) {
+        // A header deliberately exposes only whether a fork cut exists, not its
+        // integer. An unseeded lifecycle has the exact cut 0 and may use the cache;
+        // a seeded lifecycle must read the body before an identity seq can be
+        // classified as inherited or owned.
+        if (cache !== undefined && !header.isSeeded) {
             let cached;
             try {
-                cached = cache.cachedSnapshot(header, ['subagent'])?.values.subagent;
+                cached = cache.cachedSnapshot(header, SessionLogOffset(0), ['subagent'])?.values.subagent;
             }
             catch {
                 // Unlike the preparation fold below, a throwing cache read renders no
@@ -284,15 +289,11 @@ async function resolveColdIdentity(query, cache, header, hasChildren, signal) {
                 // row of ANY unit) silently falls through to the authoritative re-fold.
                 cached = undefined;
             }
-            // A child's OWN descriptor is immutable once appended, so a cached
-            // identity is final only when the seq gate proves it was folded from the
-            // own suffix: a creation-window checkpoint may instead carry a fork
-            // seed's replayed ANCESTOR descriptor (seq below `seedLength`), which
-            // must not outrank the re-fold. Everything else also falls through to
-            // preparation: an absent key (a cut before any descriptor) and the
-            // `null` sentinel, whose verdict belongs to the authoritative re-fold,
-            // not to a derived row.
-            if (cached !== undefined && cached !== null && cached.seq >= (header.seedLength ?? 0)) {
+            // An unseeded child's descriptor is owned at every valid seq. Everything
+            // else falls through to preparation: an absent key and the `null`
+            // sentinel, whose verdict belongs to the authoritative re-fold, not to a
+            // derived row.
+            if (cached !== undefined && cached !== null) {
                 return childRow(childId, cached, 'inactive', hasChildren);
             }
         }
@@ -326,7 +327,7 @@ async function resolveColdIdentity(query, cache, header, hasChildren, signal) {
         }
         const identity = ownedObservation.projections?.values.subagent;
         if (identity === undefined || identity === null
-            || identity.seq < (header.seedLength ?? 0)) {
+            || identity.seq < ownedObservation.inheritedEventCount) {
             return { kind: 'diagnostic', id: childId, reason: 'corrupt' };
         }
         return childRow(childId, identity, 'inactive', hasChildren);
@@ -361,7 +362,7 @@ function childRow(id, identity, activity, hasChildren) {
 }
 /** Immutable header fields that distinguish one session lifecycle from another under the same id. */
 const LIFECYCLE_WITNESS_KEYS = [
-    'version', 'id', 'createdAt', 'cwd', 'parentSession', 'seedLength', 'delegationDepth',
+    'version', 'id', 'createdAt', 'cwd', 'parentSession', 'isSeeded', 'delegationDepth',
     'origin', 'agentPreset',
 ];
 /** Whether an inspected log still belongs to the enumerated lifecycle. */

package/lib/types/projection-types.d.ts

@@ -3,6 +3,7 @@
  *
  * @module @deepseek-ai/dsh-subagent/projection-types
  */
+import type { SessionSeq } from '@deepseek-ai/dsh-session/types';
 /** Durable active-turn timing for one descriptor-backed child session. */
 export interface SubagentTimingProjection {
     /** Milliseconds accumulated across completed turns after the child's own descriptor. */
@@ -28,18 +29,18 @@ export type SubagentIdentityProjection = {
     label?: string;
     /**
      * Seq of the `subagent/descriptor` event this identity was folded from.
-     * `seq >= header.seedLength` proves the identity comes from the child's
+     * `session.isOwnSeq(seq)` proves the identity comes from the child's
      * OWN log suffix — where a descriptor is immutable once appended — and
      * not from a fork seed's replayed ancestor descriptor.
      */
-    seq: number;
+    seq: SessionSeq;
 } | {
     /** A resumable conversation. */
     mode: 'continuable';
     /** Durable creation label from the child's descriptor. */
     label: string;
     /** Seq of the folded descriptor event; see the one-shot arm for the own-suffix proof. */
-    seq: number;
+    seq: SessionSeq;
 };
 declare module '@deepseek-ai/dsh-session-projection/types' {
     interface SessionProjectionMap {

package/lib/types/projection.js

@@ -5,6 +5,7 @@
  * @module @deepseek-ai/dsh-subagent/projection
  */
 import { z } from 'zod';
+import { SessionSeq } from '@deepseek-ai/dsh-session';
 import { foldSubagentDescriptor } from "./descriptor.js";
 const activeIntervalSchema = z.object({
     since: z.number().int().nonnegative(),
@@ -88,12 +89,12 @@ const identityValueSchema = z.discriminatedUnion('mode', [
     z.object({
         mode: z.literal('one-shot'),
         label: z.string().optional(),
-        seq: z.number().int().nonnegative(),
+        seq: z.number().int().nonnegative().max(Number.MAX_SAFE_INTEGER).transform(SessionSeq),
     }).strict(),
     z.object({
         mode: z.literal('continuable'),
         label: z.string(),
-        seq: z.number().int().nonnegative(),
+        seq: z.number().int().nonnegative().max(Number.MAX_SAFE_INTEGER).transform(SessionSeq),
     }).strict(),
 ]);
 const identitySchema = identityValueSchema.nullable();

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.2-alpha.2",
+  "version": "0.1.2-alpha.4",
   "publishConfig": {
     "access": "public"
   },
@@ -18,6 +18,10 @@
       "types": "./lib/types/index.d.ts",
       "default": "./lib/index.js"
     },
+    "./internal": {
+      "types": "./lib/types/internal.d.ts",
+      "default": "./lib/types/internal.js"
+    },
     "./invariant": {
       "types": "./lib/types/invariant.d.ts",
       "default": "./lib/invariant.js"
@@ -50,30 +54,30 @@
   "license": "MIT",
   "dependencies": {
     "zod": "^4.4.3",
-    "@deepseek-ai/dsh-brand": "^0.1.2-alpha.2",
-    "@deepseek-ai/dsh-util-values": "^0.1.2-alpha.2"
+    "@deepseek-ai/dsh-util-values": "^0.1.2-alpha.4",
+    "@deepseek-ai/dsh-brand": "^0.1.2-alpha.4"
   },
   "peerDependencies": {
     "@deepseek-ai/cordis": "^4.0.2",
-    "@deepseek-ai/dsh-agent": "^0.1.2-alpha.2",
-    "@deepseek-ai/dsh-agent-presets": "^0.1.2-alpha.2",
-    "@deepseek-ai/dsh-attachment": "^0.1.2-alpha.2",
-    "@deepseek-ai/dsh-invariants": "^0.1.2-alpha.2",
-    "@deepseek-ai/dsh-jobs": "^0.1.2-alpha.2",
-    "@deepseek-ai/dsh-llm": "^0.1.2-alpha.2",
-    "@deepseek-ai/dsh-sandbox": "^0.1.2-alpha.2",
-    "@deepseek-ai/dsh-sandbox-policy": "^0.1.2-alpha.2",
-    "@deepseek-ai/dsh-scope": "^0.1.2-alpha.2",
-    "@deepseek-ai/dsh-session": "^0.1.2-alpha.2",
-    "@deepseek-ai/dsh-session-persistence": "^0.1.2-alpha.2",
-    "@deepseek-ai/dsh-session-projection-cache": "^0.1.2-alpha.2",
-    "@deepseek-ai/dsh-session-query": "^0.1.2-alpha.2",
-    "@deepseek-ai/dsh-system-prompt": "^0.1.2-alpha.2",
-    "@deepseek-ai/dsh-tools": "^0.1.2-alpha.2",
-    "@deepseek-ai/dsh-typert-protocol": "^0.1.2-alpha.2",
-    "@deepseek-ai/dsh-session-projection": "^0.1.2-alpha.2",
-    "@deepseek-ai/dsh-user-approval": "^0.1.2-alpha.2",
-    "@deepseek-ai/dsh-util-time": "^0.1.2-alpha.2"
+    "@deepseek-ai/dsh-agent": "^0.1.2-alpha.4",
+    "@deepseek-ai/dsh-agent-presets": "^0.1.2-alpha.4",
+    "@deepseek-ai/dsh-attachment": "^0.1.2-alpha.4",
+    "@deepseek-ai/dsh-invariants": "^0.1.2-alpha.4",
+    "@deepseek-ai/dsh-jobs": "^0.1.2-alpha.4",
+    "@deepseek-ai/dsh-llm": "^0.1.2-alpha.4",
+    "@deepseek-ai/dsh-sandbox": "^0.1.2-alpha.4",
+    "@deepseek-ai/dsh-sandbox-policy": "^0.1.2-alpha.4",
+    "@deepseek-ai/dsh-scope": "^0.1.2-alpha.4",
+    "@deepseek-ai/dsh-session": "^0.1.2-alpha.4",
+    "@deepseek-ai/dsh-session-projection": "^0.1.2-alpha.4",
+    "@deepseek-ai/dsh-session-projection-cache": "^0.1.2-alpha.4",
+    "@deepseek-ai/dsh-session-query": "^0.1.2-alpha.4",
+    "@deepseek-ai/dsh-system-prompt": "^0.1.2-alpha.4",
+    "@deepseek-ai/dsh-tools": "^0.1.2-alpha.4",
+    "@deepseek-ai/dsh-typert-protocol": "^0.1.2-alpha.4",
+    "@deepseek-ai/dsh-user-approval": "^0.1.2-alpha.4",
+    "@deepseek-ai/dsh-session-persistence": "^0.1.2-alpha.4",
+    "@deepseek-ai/dsh-util-time": "^0.1.2-alpha.4"
   },
   "peerDependenciesMeta": {
     "@deepseek-ai/dsh-agent-presets": {
@@ -106,27 +110,27 @@
   },
   "devDependencies": {
     "@deepseek-ai/cordis": "^4.0.2",
-    "@deepseek-ai/dsh-agent": "^0.1.2-alpha.2",
-    "@deepseek-ai/dsh-attachment": "^0.1.2-alpha.2",
-    "@deepseek-ai/dsh-agent-presets": "^0.1.2-alpha.2",
-    "@deepseek-ai/dsh-invariants": "^0.1.2-alpha.2",
-    "@deepseek-ai/dsh-jobs": "^0.1.2-alpha.2",
-    "@deepseek-ai/dsh-llm": "^0.1.2-alpha.2",
-    "@deepseek-ai/dsh-sandbox": "^0.1.2-alpha.2",
-    "@deepseek-ai/dsh-sandbox-policy": "^0.1.2-alpha.2",
-    "@deepseek-ai/dsh-scope": "^0.1.2-alpha.2",
-    "@deepseek-ai/dsh-session": "^0.1.2-alpha.2",
-    "@deepseek-ai/dsh-session-persistence": "^0.1.2-alpha.2",
-    "@deepseek-ai/dsh-session-projection": "^0.1.2-alpha.2",
-    "@deepseek-ai/dsh-session-projection-cache": "^0.1.2-alpha.2",
-    "@deepseek-ai/dsh-storage-domain": "^0.1.2-alpha.2",
-    "@deepseek-ai/dsh-storage-json": "^0.1.2-alpha.2",
-    "@deepseek-ai/dsh-system-prompt": "^0.1.2-alpha.2",
-    "@deepseek-ai/dsh-tools": "^0.1.2-alpha.2",
-    "@deepseek-ai/dsh-typert-protocol": "^0.1.2-alpha.2",
-    "@deepseek-ai/dsh-user-approval": "^0.1.2-alpha.2",
-    "@deepseek-ai/dsh-util-time": "^0.1.2-alpha.2",
-    "@deepseek-ai/dsh-storage": "^0.1.2-alpha.2",
-    "@deepseek-ai/dsh-session-query": "^0.1.2-alpha.2"
+    "@deepseek-ai/dsh-agent": "^0.1.2-alpha.4",
+    "@deepseek-ai/dsh-agent-presets": "^0.1.2-alpha.4",
+    "@deepseek-ai/dsh-attachment": "^0.1.2-alpha.4",
+    "@deepseek-ai/dsh-jobs": "^0.1.2-alpha.4",
+    "@deepseek-ai/dsh-llm": "^0.1.2-alpha.4",
+    "@deepseek-ai/dsh-invariants": "^0.1.2-alpha.4",
+    "@deepseek-ai/dsh-sandbox": "^0.1.2-alpha.4",
+    "@deepseek-ai/dsh-sandbox-policy": "^0.1.2-alpha.4",
+    "@deepseek-ai/dsh-scope": "^0.1.2-alpha.4",
+    "@deepseek-ai/dsh-session": "^0.1.2-alpha.4",
+    "@deepseek-ai/dsh-session-projection": "^0.1.2-alpha.4",
+    "@deepseek-ai/dsh-session-projection-cache": "^0.1.2-alpha.4",
+    "@deepseek-ai/dsh-session-query": "^0.1.2-alpha.4",
+    "@deepseek-ai/dsh-storage": "^0.1.2-alpha.4",
+    "@deepseek-ai/dsh-storage-domain": "^0.1.2-alpha.4",
+    "@deepseek-ai/dsh-system-prompt": "^0.1.2-alpha.4",
+    "@deepseek-ai/dsh-session-persistence": "^0.1.2-alpha.4",
+    "@deepseek-ai/dsh-tools": "^0.1.2-alpha.4",
+    "@deepseek-ai/dsh-typert-protocol": "^0.1.2-alpha.4",
+    "@deepseek-ai/dsh-user-approval": "^0.1.2-alpha.4",
+    "@deepseek-ai/dsh-util-time": "^0.1.2-alpha.4",
+    "@deepseek-ai/dsh-storage-json": "^0.1.2-alpha.4"
   }
 }

package/lib/types/activation-setup-registry.d.ts

@@ -1,57 +0,0 @@
-/**
- * Internal registry of deployment capabilities composed into every continuable
- * child's unpublished creation context.
- *
- * A contribution grants a child-scoped capability without teaching the
- * continuation manager which capabilities exist. The manager owns residency;
- * this registry owns the join between plugin lifetime, unpublished setup, and
- * Activation disposal, so no installation outlives either owner and no removed
- * contribution can be installed after revocation reports completion.
- *
- * @module @deepseek-ai/dsh-subagent/activation-setup-registry
- */
-import type { Context } from '@deepseek-ai/cordis';
-import type { AgentSetupCommit } from '@deepseek-ai/dsh-agent';
-/**
- * One deployment capability installed into a continuable child's unpublished
- * creation context. It composes synchronously before publication and returns
- * the disposer for exactly that installation.
- * @param childCtx - the child's unpublished scoped context.
- * @returns the disposer revoking this installation.
- */
-export type ContinuableSetupContribution = (childCtx: Context) => () => void;
-/**
- * Owns continuable-child setup registrations, installations, rollback, child
- * cleanup, and immediate live revocation.
- */
-export declare class SubagentActivationSetupRegistry {
-    /** Live contributions in installation order. */
-    private readonly registrations;
-    /** Child context to its live installations. */
-    private readonly byChild;
-    /**
-     * Register one contribution.
-     * @param contribution - synchronous child-scope installer.
-     * @returns an idempotent registration undo.
-     * @throws after attempting every installation when any disposer fails.
-     */
-    register(contribution: ContinuableSetupContribution): () => void;
-    /**
-     * Install every live contribution into one unpublished child context.
-     * @param childCtx - the child's unpublished scoped context.
-     * @returns the provisioning commit consumed at Agent publication.
-     */
-    apply(childCtx: Context): AgentSetupCommit;
-    /** Release every remaining installation owned by one disposed child scope. */
-    private releaseChild;
-    /**
-     * Release a batch completely before reporting disposer failures.
-     * @param installations - records to release.
-     * @param during - operation name for diagnostics.
-     */
-    private releaseAll;
-    /** Drop one installation from both indices and dispose it exactly once. */
-    private release;
-}
-export default SubagentActivationSetupRegistry;
-//# sourceMappingURL=activation-setup-registry.d.ts.map

package/lib/types/activation-setup-registry.js

@@ -1,148 +0,0 @@
-/**
- * Internal registry of deployment capabilities composed into every continuable
- * child's unpublished creation context.
- *
- * A contribution grants a child-scoped capability without teaching the
- * continuation manager which capabilities exist. The manager owns residency;
- * this registry owns the join between plugin lifetime, unpublished setup, and
- * Activation disposal, so no installation outlives either owner and no removed
- * contribution can be installed after revocation reports completion.
- *
- * @module @deepseek-ai/dsh-subagent/activation-setup-registry
- */
-import { errorChain } from '@deepseek-ai/dsh-llm';
-import { SubagentError } from "./error.js";
-/** Re-read mutable removal state after a contribution may have revoked itself. */
-function isRemoved(registration) {
-    return registration.removed;
-}
-/**
- * Owns continuable-child setup registrations, installations, rollback, child
- * cleanup, and immediate live revocation.
- */
-export class SubagentActivationSetupRegistry {
-    /** Live contributions in installation order. */
-    registrations = new Set();
-    /** Child context to its live installations. */
-    byChild = new Map();
-    /**
-     * Register one contribution.
-     * @param contribution - synchronous child-scope installer.
-     * @returns an idempotent registration undo.
-     * @throws after attempting every installation when any disposer fails.
-     */
-    register(contribution) {
-        const registration = { contribution, removed: false, installations: new Set() };
-        this.registrations.add(registration);
-        return () => {
-            if (registration.removed)
-                return;
-            // Close before disposal so a snapshotted apply() cannot install after
-            // revocation reports completion.
-            registration.removed = true;
-            this.registrations.delete(registration);
-            this.releaseAll([...registration.installations], 'contribution removal');
-        };
-    }
-    /**
-     * Install every live contribution into one unpublished child context.
-     * @param childCtx - the child's unpublished scoped context.
-     * @returns the provisioning commit consumed at Agent publication.
-     */
-    apply(childCtx) {
-        const state = { installations: [], invalidated: false };
-        try {
-            for (const registration of [...this.registrations]) {
-                /* v8 ignore next -- only a synchronous re-entrant revocation of an
-                 * already-snapshotted registration reaches this guard. */
-                if (registration.removed)
-                    continue;
-                const installation = {
-                    registration,
-                    childCtx,
-                    dispose: registration.contribution(childCtx),
-                    released: false,
-                    transaction: state,
-                };
-                registration.installations.add(installation);
-                state.installations.push(installation);
-                let indexed = this.byChild.get(childCtx);
-                if (indexed === undefined) {
-                    indexed = new Set();
-                    this.byChild.set(childCtx, indexed);
-                }
-                indexed.add(installation);
-                // An installer may revoke itself before its installation record exists.
-                // Dispose that escaped record and invalidate the provisioning batch.
-                if (isRemoved(registration))
-                    this.release(installation);
-            }
-        }
-        catch (error) {
-            // Keep the installer failure authoritative, but attempt every rollback.
-            try {
-                this.releaseAll([...state.installations], 'setup rollback');
-            }
-            catch (releaseFailure) {
-                /* v8 ignore next -- requires independent installer and rollback faults. */
-                void releaseFailure;
-            }
-            throw error;
-        }
-        childCtx.effect(() => () => { this.releaseChild(childCtx); }, 'subagents.activationSetup()');
-        return {
-            commit: () => {
-                if (state.invalidated) {
-                    throw new SubagentError('a continuable-subagent setup contribution was revoked while this child was being built; '
-                        + 'the child was not established', 'ACTIVATION_SETUP_REVOKED');
-                }
-                for (const installation of state.installations)
-                    installation.transaction = undefined;
-            },
-        };
-    }
-    /** Release every remaining installation owned by one disposed child scope. */
-    releaseChild(childCtx) {
-        const indexed = this.byChild.get(childCtx) ?? [];
-        this.releaseAll([...indexed], 'child scope disposal');
-    }
-    /**
-     * Release a batch completely before reporting disposer failures.
-     * @param installations - records to release.
-     * @param during - operation name for diagnostics.
-     */
-    releaseAll(installations, during) {
-        const failures = [];
-        for (const installation of installations) {
-            try {
-                this.release(installation);
-            }
-            catch (error) {
-                failures.push(error);
-            }
-        }
-        if (failures.length === 0)
-            return;
-        throw new SubagentError(`continuable-subagent setup ${during} failed to release ${failures.length} installation(s): `
-            + failures.map(failure => errorChain(failure)).join('; '), 'ACTIVATION_SETUP_RELEASE_FAILED');
-    }
-    /** Drop one installation from both indices and dispose it exactly once. */
-    release(installation) {
-        if (installation.released)
-            return;
-        installation.released = true;
-        installation.registration.installations.delete(installation);
-        const indexed = this.byChild.get(installation.childCtx);
-        /* v8 ignore next 4 -- every live installation is indexed until this method removes it. */
-        if (indexed !== undefined) {
-            indexed.delete(installation);
-            if (indexed.size === 0)
-                this.byChild.delete(installation.childCtx);
-        }
-        if (installation.transaction !== undefined)
-            installation.transaction.invalidated = true;
-        installation.dispose();
-    }
-}
-export default SubagentActivationSetupRegistry;
-//# sourceMappingURL=activation-setup-registry.js.map