@xneog/dsh-subagent 0.1.0 → 0.1.3-alpha.1

package/lib/types/out-of-process.js

@@ -12,13 +12,42 @@
  */
 import { accessSync, constants, statSync } from 'node:fs';
 import { isAbsolute, resolve } from 'node:path';
+/** Maximum UTF-8 size of {@link SubagentResult.diagnostic}. */
+const MAX_SUBAGENT_DIAGNOSTIC_BYTES = 4_096;
+const DIAGNOSTIC_TRUNCATION_SUFFIX = '\n[diagnostic truncated]';
+const utf8Encoder = new TextEncoder();
+const utf8Decoder = new TextDecoder();
+/**
+ * Limit provider-authored failure detail without splitting a UTF-8 sequence.
+ * @param diagnostic - safe diagnostic text produced by the provider.
+ * @returns the original text, or a visibly truncated value within the limit.
+ */
+function limitSubagentDiagnostic(diagnostic) {
+    const bytes = utf8Encoder.encode(diagnostic);
+    if (bytes.byteLength <= MAX_SUBAGENT_DIAGNOSTIC_BYTES)
+        return diagnostic;
+    const suffixBytes = utf8Encoder.encode(DIAGNOSTIC_TRUNCATION_SUFFIX).byteLength;
+    let prefixBytes = MAX_SUBAGENT_DIAGNOSTIC_BYTES - suffixBytes;
+    while ((bytes[prefixBytes] & 0b1100_0000) === 0b1000_0000) {
+        prefixBytes -= 1;
+    }
+    return utf8Decoder.decode(bytes.subarray(0, prefixBytes))
+        + DIAGNOSTIC_TRUNCATION_SUFFIX;
+}
+/** Enforce the byte limit on a provider-returned diagnostic. */
+function normalizeSubagentDiagnostic(result) {
+    return result.diagnostic === undefined
+        ? result
+        : { ...result, diagnostic: limitSubagentDiagnostic(result.diagnostic) };
+}
 /**
  * The capability advertisement of an out-of-process backend: NONE. A child in
  * another process cannot honor parent-enforced start features
- * (`outputSchema`/`maxDepth`/`toolFilter`/`persona`), so the service rejects a
+ * (`agentOptions`/`outputSchema`/`maxDepth`/`toolFilter`/`persona`), so the service rejects a
  * request needing any of them before `start` runs — never accepted-then-ignored.
  */
 export const NO_START_CAPABILITIES = Object.freeze({
+    agentOptions: false,
     outputSchema: false,
     depthLimit: false,
     toolFilter: false,
@@ -126,7 +155,8 @@ function toError(value) {
  * rejects after publication. A normally completed or rejected attempt resolves
  * as `aborted` when cancellation already settled locally; another rejection is
  * flattened to `stopReason: 'error'` through the contained diagnostic sink.
- * The abort listener is removed on every path.
+ * Provider-returned diagnostics use the same byte limit. The abort listener is
+ * removed on every path.
  * @param parts - the attempt, output snapshot, cancellation state, sink, and signal wiring.
  * @returns the terminal result (never a rejection).
  */
@@ -135,7 +165,7 @@ export async function settleRunResult(parts) {
         const result = await parts.attempt();
         return parts.cancelled()
             ? { output: parts.collectOutput(), stopReason: 'aborted' }
-            : result;
+            : normalizeSubagentDiagnostic(result);
     }
     catch (error) {
         // Cover a rejection already queued when cancellation arrives.
@@ -148,7 +178,15 @@ export async function settleRunResult(parts) {
         catch {
             // The diagnostic sink cannot reject the run result.
         }
-        return { output: parts.collectOutput(), stopReason: 'error' };
+        const collected = parts.collectDiagnostic?.();
+        const diagnostic = collected === undefined
+            ? undefined
+            : limitSubagentDiagnostic(collected);
+        return {
+            output: parts.collectOutput(),
+            ...diagnostic === undefined ? {} : { diagnostic },
+            stopReason: 'error',
+        };
     }
     finally {
         parts.signal.removeEventListener('abort', parts.onAbort);

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

@@ -3,6 +3,7 @@
  *
  * @module @xneog/dsh-subagent/projection-types
  */
+import type { SessionSeq } from '@xneog/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 '@xneog/dsh-session-projection/types' {
     interface SessionProjectionMap {

package/lib/types/projection.d.ts

@@ -4,21 +4,29 @@
  *
  * @module @xneog/dsh-subagent/projection
  */
-import type { ProjectionDefinition } from '@xneog/dsh-session-projection';
-import type { SubagentIdentityProjection } from './projection-types.ts';
-interface TimingState {
+import { z } from 'zod';
+import type { SessionEvent } from '@xneog/dsh-session';
+import type { SubagentIdentityProjection, SubagentTimingProjection } from './projection-types.ts';
+/** Fold state for a subagent's latest timing snapshot. */
+export interface TimingState {
     /** Milliseconds accumulated across completed post-descriptor turns. */
     settledMs: number;
     /** Current open interval kept paired inside the fold. */
     active?: {
         since: number;
         through: number;
-    };
+    } | undefined;
     /** Latest pre-descriptor turn start, promoted when the child's own descriptor arrives. */
-    pendingTurnStart?: number;
+    pendingTurnStart?: number | undefined;
     /** Whether the fold has crossed a descriptor in this logical log. */
     descriptorSeen: boolean;
 }
+declare module '@xneog/dsh-session-projection/types' {
+    interface SessionProjectionStateMap {
+        subagentTiming: TimingState;
+        subagent: IdentityState;
+    }
+}
 /**
  * Fold turn boundaries around the child's own durable descriptor.
  *
@@ -27,10 +35,39 @@ interface TimingState {
  * admits only a child with exactly one descriptor in its own suffix, making
  * the final reset the child's authoritative timing origin.
  */
-export declare const subagentTimingProjectionDefinition: ProjectionDefinition<'subagentTiming', TimingState>;
+export declare const subagentTimingProjectionDefinition: {
+    key: "subagentTiming";
+    stateSchema: z.ZodType<TimingState, unknown, z.core.$ZodTypeInternals<TimingState, unknown>>;
+    init: () => {
+        descriptorSeen: false;
+        settledMs: number;
+    };
+    apply: (state: NoInfer<TimingState>, event: SessionEvent) => {
+        /** Milliseconds accumulated across completed post-descriptor turns. */
+        settledMs: number;
+        /** Current open interval kept paired inside the fold. */
+        active?: {
+            since: number;
+            through: number;
+        } | undefined;
+        /** Whether the fold has crossed a descriptor in this logical log. */
+        descriptorSeen: boolean;
+    };
+    wire: {
+        viewSchema: z.ZodType<SubagentTimingProjection, unknown, z.core.$ZodTypeInternals<SubagentTimingProjection, unknown>>;
+        view: (state: NoInfer<TimingState>) => {
+            active?: {
+                since: number;
+                through: number;
+            };
+            settledMs: number;
+        };
+    };
+    stateVersion: number;
+};
 interface IdentityState {
     /** Identity from the last valid descriptor; absent before one, and after an invalid one. */
-    identity?: SubagentIdentityProjection;
+    identity?: SubagentIdentityProjection | undefined;
 }
 /**
  * Fold the durable mode/label identity from `subagent/descriptor` events,
@@ -43,6 +80,16 @@ interface IdentityState {
  * holding the earlier identity replaces it instead of keeping it stale;
  * `null` ⟺ no valid descriptor, with the causes deliberately undistinguished.
  */
-export declare const subagentIdentityProjectionDefinition: ProjectionDefinition<'subagent', IdentityState>;
+export declare const subagentIdentityProjectionDefinition: {
+    key: "subagent";
+    stateSchema: z.ZodType<IdentityState, unknown, z.core.$ZodTypeInternals<IdentityState, unknown>>;
+    init: () => {};
+    apply: (state: NoInfer<IdentityState>, event: SessionEvent) => IdentityState;
+    wire: {
+        viewSchema: z.ZodNullable<z.ZodType<SubagentIdentityProjection, unknown, z.core.$ZodTypeInternals<SubagentIdentityProjection, unknown>>>;
+        view: (state: NoInfer<IdentityState>) => SubagentIdentityProjection | null;
+    };
+    stateVersion: number;
+};
 export {};
 //# sourceMappingURL=projection.d.ts.map

package/lib/types/projection.js

@@ -5,15 +5,24 @@
  * @module @xneog/dsh-subagent/projection
  */
 import { z } from 'zod';
+import { SessionSeq } from '@xneog/dsh-session';
 import { foldSubagentDescriptor } from "./descriptor.js";
-// Zod's optional output includes explicit `undefined`; with
-// exactOptionalPropertyTypes the public interface permits omission only.
+const activeIntervalSchema = z.object({
+    since: z.number().int().nonnegative(),
+    through: z.number().int().nonnegative(),
+}).strict();
 const projectionSchema = z.object({
     settledMs: z.number().int().nonnegative(),
-    active: z.object({
-        since: z.number().int().nonnegative(),
-        through: z.number().int().nonnegative(),
-    }).strict().optional(),
+    active: activeIntervalSchema.optional(),
+}).strict().transform(({ settledMs, active }) => ({
+    settledMs,
+    ...active === undefined ? {} : { active },
+}));
+const timingStateSchema = z.object({
+    settledMs: z.number().int().nonnegative(),
+    active: activeIntervalSchema.optional(),
+    pendingTurnStart: z.number().int().nonnegative().optional(),
+    descriptorSeen: z.boolean(),
 }).strict();
 /**
  * Fold turn boundaries around the child's own durable descriptor.
@@ -25,7 +34,7 @@ const projectionSchema = z.object({
  */
 export const subagentTimingProjectionDefinition = {
     key: 'subagentTiming',
-    schema: projectionSchema,
+    stateSchema: timingStateSchema,
     init: () => ({ descriptorSeen: false, settledMs: 0 }),
     apply: (state, event) => {
         if (event.type === 'turn/start') {
@@ -62,10 +71,13 @@ export const subagentTimingProjectionDefinition = {
             return state;
         return { ...state, active: { ...state.active, through: event.time } };
     },
-    view: state => ({
-        settledMs: state.settledMs,
-        ...(state.active === undefined ? {} : { active: state.active }),
-    }),
+    wire: {
+        viewSchema: projectionSchema,
+        view: state => ({
+            settledMs: state.settledMs,
+            ...(state.active === undefined ? {} : { active: state.active }),
+        }),
+    },
     stateVersion: 2,
 };
 // The cast bridges only the optional-label arm: Zod's optional output
@@ -73,18 +85,22 @@ export const subagentTimingProjectionDefinition = {
 // from the public interface. The no-value state itself is the serializable
 // `null` arm — never `undefined` — so every registry read and push frame
 // survives JSON.stringify losslessly.
-const identitySchema = z.discriminatedUnion('mode', [
+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(),
-]).nullable();
+]);
+const identitySchema = identityValueSchema.nullable();
+const identityStateSchema = z.object({
+    identity: identityValueSchema.optional(),
+}).strict();
 /** Interpret one `subagent/descriptor` event's identity; no value when the payload cannot be trusted. */
 function descriptorIdentity(event) {
     let descriptor;
@@ -119,7 +135,7 @@ function descriptorIdentity(event) {
  */
 export const subagentIdentityProjectionDefinition = {
     key: 'subagent',
-    schema: identitySchema,
+    stateSchema: identityStateSchema,
     init: () => ({}),
     apply: (state, event) => {
         if (event.type !== 'subagent/descriptor')
@@ -127,7 +143,7 @@ export const subagentIdentityProjectionDefinition = {
         const identity = descriptorIdentity(event);
         return identity === undefined ? {} : { identity };
     },
-    view: state => state.identity ?? null,
+    wire: { viewSchema: identitySchema, view: state => state.identity ?? null },
     // Bumped when the identity gained its `seq` field: an older checkpoint row
     // would replay into a value the schema rejects, so it must refold instead.
     stateVersion: 2,

package/lib/types/run-settlement.js

@@ -12,9 +12,18 @@ function finalText(blocks) {
         .map(block => block.text)
         .join('');
 }
+/** Render a failed stop reason with optional provider-authored detail. */
+function failureDetail(result) {
+    const stopReason = result.stopReason;
+    return result.diagnostic === undefined
+        ? stopReason
+        : `${stopReason}; diagnostic: ${result.diagnostic}`;
+}
 /**
- * Map a child result to the task outcome: completed carries final text,
- * aborted is killed, and every other reason is failed without partial output.
+ * Map a child result to the task outcome: completed carries final text, local
+ * cancellation (`aborted` without a diagnostic) is killed, and provider-
+ * diagnosed remote aborts plus every other reason are failed without partial
+ * output.
  * @param result - child terminal result.
  * @returns outcome for the `ctx.jobs` registration.
  */
@@ -23,14 +32,16 @@ function runOutcome(result) {
         case 'completed':
             return { status: 'completed', output: finalText(result.output) };
         case 'aborted':
-            return { status: 'killed' };
+            return result.diagnostic === undefined
+                ? { status: 'killed' }
+                : { status: 'failed', detail: failureDetail(result) };
         case 'error':
         case 'max-tokens':
         case 'refusal':
-            return { status: 'failed', detail: result.stopReason };
-        // Merge-extensible reasons remain failures with their raw detail.
+            return { status: 'failed', detail: failureDetail(result) };
+        // Merge-extensible reasons remain failures with provider-authored detail.
         default:
-            return { status: 'failed', detail: String(result.stopReason) };
+            return { status: 'failed', detail: failureDetail(result) };
     }
 }
 /**

package/lib/types/types.d.ts

@@ -76,6 +76,7 @@ export interface SubagentRunEndInfo {
  * to `maxDepth`; the other names match.
  */
 export interface SubagentCapabilities {
+    readonly agentOptions: boolean;
     readonly outputSchema: boolean;
     readonly depthLimit: boolean;
     readonly toolFilter: boolean;
@@ -107,6 +108,13 @@ export interface SubagentStartRequest {
      * remaining turn work when it fires afterward.
      */
     readonly signal: AbortSignal;
+    /**
+     * Optional host-Agent provider, model, reasoning-effort, and output-token
+     * overrides. Requires {@link SubagentCapabilities.agentOptions}; in-process
+     * providers merge them over the parent Agent's options when they create the
+     * child, while the DSH SDK provider merges them over its instance defaults
+     * before initializing the separate child runtime.
+     */
     readonly agentOptions?: AgentOptions;
     /**
      * Object-rooted JSON Schema within `assertObjectJsonSchema`'s enforced subset. Start rejects
@@ -218,6 +226,13 @@ export interface SubagentResult {
      * schema-agnostic.
      */
     readonly structured?: unknown;
+    /**
+     * Provider-authored, non-assistant failure detail for a non-`completed`
+     * result. Providers keep this text free of tool inputs, file contents,
+     * environment values, credentials, and raw protocol payloads, and limit it
+     * to 4096 UTF-8 bytes. Consumers present it separately from {@link output}.
+     */
+    readonly diagnostic?: string;
     /** Why the run ended. A non-`completed` reason means `output` may be partial. */
     readonly stopReason: SubagentStopReason;
 }
@@ -276,6 +291,16 @@ export interface SubagentProvider {
      * It says nothing about tool registration, injected services, or authority inheritance.
      */
     readonly inheritsParentContext: boolean;
+    /**
+     * Optional static provider-owned provider/model route for one-shot Agent
+     * options. Consumers merge tool/model overrides over these values before
+     * preflight; providers whose route derives from the parent omit it. The value
+     * is detached immutable data and requires `agentOptions` support.
+     */
+    readonly agentRouteDefaults?: Readonly<{
+        provider: string;
+        model: string;
+    }>;
     /**
      * Establish a ONE-SHOT child and return its handle after publication.
      * The service has already validated that every requested start-time

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@xneog/dsh-subagent",
   "description": "Abstract subagent seam (ctx.subagents): named-provider registry for delegating to child agents",
-  "version": "0.1.0",
+  "version": "0.1.3-alpha.1",
   "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"
@@ -26,6 +30,14 @@
       "types": "./lib/types/client.d.ts",
       "default": "./lib/types/client.js"
     },
+    "./typert": {
+      "types": "./lib/typert.host.d.ts",
+      "default": "./lib/typert.host.js"
+    },
+    "./remote": {
+      "types": "./lib/typert.remote-client.d.ts",
+      "default": "./lib/typert.remote-client.js"
+    },
     "./src/*": "./src/*",
     "./package.json": "./package.json"
   },
@@ -33,29 +45,39 @@
     "lib/index.js",
     "lib/invariant.js",
     "lib/types/**/*.js",
-    "lib/types/**/*.d.ts"
+    "lib/types/**/*.d.ts",
+    "lib/typert.host.js",
+    "lib/typert.host.d.ts",
+    "lib/typert.remote-client.js",
+    "lib/typert.remote-client.d.ts"
   ],
   "license": "MIT",
   "dependencies": {
-    "zod": "^4.4.3"
+    "zod": "^4.4.3",
+    "@xneog/dsh-brand": "^0.1.3-alpha.1",
+    "@xneog/dsh-util-values": "^0.1.3-alpha.1"
   },
   "peerDependencies": {
-    "@xneog/dsh-agent": "0.1.0",
-    "@xneog/dsh-agent-presets": "0.1.0",
-    "@xneog/dsh-brand": "0.1.0",
-    "@xneog/dsh-invariants": "0.1.0",
-    "@xneog/dsh-llm": "0.1.0",
-    "@xneog/dsh-sandbox": "0.1.0",
-    "@xneog/dsh-sandbox-policy": "0.1.0",
-    "@xneog/dsh-scope": "0.1.0",
-    "@xneog/dsh-session": "0.1.0",
-    "@xneog/dsh-session-persistence": "0.1.0",
-    "@xneog/dsh-session-projection": "0.1.0",
-    "@xneog/dsh-session-projection-cache": "0.1.0",
-    "@xneog/dsh-jobs": "0.1.0",
-    "@xneog/dsh-tools": "0.1.0",
-    "@xneog/dsh-user-approval": "0.1.0",
-    "@xneog/cordis": "0.1.0"
+    "@xneog/cordis": "^4.0.2",
+    "@xneog/dsh-agent-presets": "^0.1.3-alpha.1",
+    "@xneog/dsh-invariants": "^0.1.3-alpha.1",
+    "@xneog/dsh-llm": "^0.1.3-alpha.1",
+    "@xneog/dsh-sandbox-policy": "^0.1.3-alpha.1",
+    "@xneog/dsh-scope": "^0.1.3-alpha.1",
+    "@xneog/dsh-session": "^0.1.3-alpha.1",
+    "@xneog/dsh-jobs": "^0.1.3-alpha.1",
+    "@xneog/dsh-agent": "^0.1.3-alpha.1",
+    "@xneog/dsh-attachment": "^0.1.3-alpha.1",
+    "@xneog/dsh-sandbox": "^0.1.3-alpha.1",
+    "@xneog/dsh-session-persistence": "^0.1.3-alpha.1",
+    "@xneog/dsh-session-projection": "^0.1.3-alpha.1",
+    "@xneog/dsh-tools": "^0.1.3-alpha.1",
+    "@xneog/dsh-session-query": "^0.1.3-alpha.1",
+    "@xneog/dsh-system-prompt": "^0.1.3-alpha.1",
+    "@xneog/dsh-user-approval": "^0.1.3-alpha.1",
+    "@xneog/dsh-session-projection-cache": "^0.1.3-alpha.1",
+    "@xneog/dsh-typert-protocol": "^0.1.3-alpha.1",
+    "@xneog/dsh-util-time": "^0.1.3-alpha.1"
   },
   "peerDependenciesMeta": {
     "@xneog/dsh-agent-presets": {
@@ -76,6 +98,9 @@
     "@xneog/dsh-session-projection-cache": {
       "optional": true
     },
+    "@xneog/dsh-session-query": {
+      "optional": true
+    },
     "@xneog/dsh-jobs": {
       "optional": true
     },
@@ -84,23 +109,28 @@
     }
   },
   "devDependencies": {
-    "@xneog/dsh-agent": "0.1.0",
-    "@xneog/dsh-agent-presets": "0.1.0",
-    "@xneog/dsh-brand": "0.1.0",
-    "@xneog/dsh-invariants": "0.1.0",
-    "@xneog/dsh-llm": "0.1.0",
-    "@xneog/dsh-sandbox": "0.1.0",
-    "@xneog/dsh-sandbox-policy": "0.1.0",
-    "@xneog/dsh-scope": "0.1.0",
-    "@xneog/dsh-session": "0.1.0",
-    "@xneog/dsh-session-persistence": "0.1.0",
-    "@xneog/dsh-session-projection": "0.1.0",
-    "@xneog/dsh-session-projection-cache": "0.1.0",
-    "@xneog/dsh-storage": "0.1.0",
-    "@xneog/dsh-storage-domain": "0.1.0",
-    "@xneog/dsh-jobs": "0.1.0",
-    "@xneog/dsh-tools": "0.1.0",
-    "@xneog/dsh-user-approval": "0.1.0",
-    "@xneog/cordis": "0.1.0"
+    "@xneog/cordis": "^4.0.2",
+    "@xneog/dsh-agent": "^0.1.3-alpha.1",
+    "@xneog/dsh-attachment": "^0.1.3-alpha.1",
+    "@xneog/dsh-agent-presets": "^0.1.3-alpha.1",
+    "@xneog/dsh-llm": "^0.1.3-alpha.1",
+    "@xneog/dsh-jobs": "^0.1.3-alpha.1",
+    "@xneog/dsh-sandbox": "^0.1.3-alpha.1",
+    "@xneog/dsh-sandbox-policy": "^0.1.3-alpha.1",
+    "@xneog/dsh-session": "^0.1.3-alpha.1",
+    "@xneog/dsh-session-persistence": "^0.1.3-alpha.1",
+    "@xneog/dsh-session-projection": "^0.1.3-alpha.1",
+    "@xneog/dsh-session-projection-cache": "^0.1.3-alpha.1",
+    "@xneog/dsh-session-query": "^0.1.3-alpha.1",
+    "@xneog/dsh-scope": "^0.1.3-alpha.1",
+    "@xneog/dsh-storage": "^0.1.3-alpha.1",
+    "@xneog/dsh-invariants": "^0.1.3-alpha.1",
+    "@xneog/dsh-system-prompt": "^0.1.3-alpha.1",
+    "@xneog/dsh-tools": "^0.1.3-alpha.1",
+    "@xneog/dsh-typert-protocol": "^0.1.3-alpha.1",
+    "@xneog/dsh-storage-json": "^0.1.3-alpha.1",
+    "@xneog/dsh-util-time": "^0.1.3-alpha.1",
+    "@xneog/dsh-user-approval": "^0.1.3-alpha.1",
+    "@xneog/dsh-storage-domain": "^0.1.3-alpha.1"
   }
 }

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 @xneog/dsh-subagent/activation-setup-registry
- */
-import type { Context } from '@xneog/cordis';
-import type { AgentSetupCommit } from '@xneog/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