@demicodes/agent 0.19.1 → 0.19.2

package/dist/client-entry.d.mts

@@ -1,4 +1,4 @@
-import { f as TranscriptPatch, l as ServerFrame, n as AgentServerTransport, o as ClientFrame, r as AgentTransport, s as ClientSessionEvent, t as AgentClientTransport, u as ShellCommandStatusLike, x as AgentMetadata } from "./transport-BRqZoaeo.mjs";
-import { a as AgentClient, i as AgentActionOptions, n as createWebSocketClientTransport, o as AgentClientListener, r as createWebSocketServerTransport, t as JsonWebSocket } from "./websocket-transport-C6Y5CeLG.mjs";
+import { f as TranscriptPatch, l as ServerFrame, n as AgentServerTransport, o as ClientFrame, r as AgentTransport, s as ClientSessionEvent, t as AgentClientTransport, u as ShellCommandStatusLike, x as AgentMetadata } from "./transport-CHrPzcrU.mjs";
+import { a as AgentClient, i as AgentActionOptions, n as createWebSocketClientTransport, o as AgentClientListener, r as createWebSocketServerTransport, t as JsonWebSocket } from "./websocket-transport-NZ5Btmb4.mjs";
 import { ProviderSelection } from "@demicodes/provider";
 export { type AgentActionOptions, AgentClient, type AgentClientListener, type AgentClientTransport, type AgentMetadata, type AgentServerTransport, type AgentTransport, type ClientFrame, type ClientSessionEvent, type JsonWebSocket, type ProviderSelection, type ServerFrame, type ShellCommandStatusLike, type TranscriptPatch, createWebSocketClientTransport, createWebSocketServerTransport };

package/dist/index.d.mts

@@ -1,6 +1,6 @@
-import { A as AgentSystemPromptContext, B as CompactionWindow, C as AgentReferenceResolveContext, D as AgentSessionParams, E as AgentSessionOptions, F as ExternalMutationReservation, G as DEFAULT_TURN_RETRY_POLICY, H as TranscriptLog, I as ModelSwitchApply, J as resolveRetryPolicy, K as TurnRetryPolicy, L as SessionEvent, M as AgentToolContext, N as AgentToolInvokeContext, O as AgentSessionRestoreParams, P as AgentToolInvokeResult, R as SessionEventListener, S as AgentPromptContext, T as AgentSessionCloneParams, U as TranscriptOptions, V as DrainedTranscriptPatches, W as estimateTranscriptBlockTokens, Y as retryDelayMs, _ as AgentHarnessContext, a as createInProcessTransportPair, b as AgentLifecycleEvent, c as ConversationSummary, d as SubagentJob, f as TranscriptPatch, g as AgentHarness, h as AgentDisposeContext, i as InProcessTransportPair, j as AgentTool, k as AgentSessionStore, l as ServerFrame, m as AbortTarget, n as AgentServerTransport, o as ClientFrame, p as AbortResult, q as isRetryableCode, r as AgentTransport, s as ClientSessionEvent, t as AgentClientTransport, u as ShellCommandStatusLike, v as AgentHarnessRuntime, w as AgentSessionCheckpoint, x as AgentMetadata, y as AgentHostContext, z as SubagentProfile } from "./transport-BRqZoaeo.mjs";
-import { a as AgentClient, i as AgentActionOptions, n as createWebSocketClientTransport, o as AgentClientListener, r as createWebSocketServerTransport, t as JsonWebSocket } from "./websocket-transport-C6Y5CeLG.mjs";
-import { BashAuditEvent, BashEnvironment, BashEnvironmentOptions, Command, CommandMetadataRecord, Host, ShellCommandStatus, ShellOutputChunk } from "@demicodes/shell";
+import { A as AgentSystemPromptContext, B as CompactionWindow, C as AgentReferenceResolveContext, D as AgentSessionParams, E as AgentSessionOptions, F as ExternalMutationReservation, G as DEFAULT_TURN_RETRY_POLICY, H as TranscriptLog, I as ModelSwitchApply, J as resolveRetryPolicy, K as TurnRetryPolicy, L as SessionEvent, M as AgentToolContext, N as AgentToolInvokeContext, O as AgentSessionRestoreParams, P as AgentToolInvokeResult, R as SessionEventListener, S as AgentPromptContext, T as AgentSessionCloneParams, U as TranscriptOptions, V as DrainedTranscriptPatches, W as estimateTranscriptBlockTokens, Y as retryDelayMs, _ as AgentHarnessContext, a as createInProcessTransportPair, b as AgentLifecycleEvent, c as ConversationSummary, d as SubagentJob, f as TranscriptPatch, g as AgentHarness, h as AgentDisposeContext, i as InProcessTransportPair, j as AgentTool, k as AgentSessionStore, l as ServerFrame, m as AbortTarget, n as AgentServerTransport, o as ClientFrame, p as AbortResult, q as isRetryableCode, r as AgentTransport, s as ClientSessionEvent, t as AgentClientTransport, u as ShellCommandStatusLike, v as AgentHarnessRuntime, w as AgentSessionCheckpoint, x as AgentMetadata, y as AgentHostContext, z as SubagentProfile } from "./transport-CHrPzcrU.mjs";
+import { a as AgentClient, i as AgentActionOptions, n as createWebSocketClientTransport, o as AgentClientListener, r as createWebSocketServerTransport, t as JsonWebSocket } from "./websocket-transport-NZ5Btmb4.mjs";
+import { BashAuditEvent, BashEnvironment, BashEnvironmentOptions, Command, CommandMetadataRecord, Host, HostStore, ShellCommandStatus, ShellOutputChunk } from "@demicodes/shell";
 import { AgentProvider, Provider } from "@demicodes/provider";
 import { Block, Model, ModelMediaKind, ModelSelection, ProviderErrorDiagnostics, QueuedMessage, SessionPhase, UserContentBlock } from "@demicodes/core";
 //#region src/recovery.d.ts
@@ -353,14 +353,18 @@ interface ChildSupervisorOptions<State> {
   sessionOptions: AgentServerSessionOptions;
   /** When false, a child closing never wakes an idle parent; the host app orchestrates the wakeup from the `subagent closed` frame. */
   notifyParentOnIdle: boolean;
+  /** Backing store for child checkpoints and job metadata, keyed under the parent's session directory. */
+  store: HostStore;
   emit(frame: ServerFrame): void;
 }
 /**
  * Per-parent subagent supervisor. Owns every child `AgentSession` this parent
  * spawns: lifecycle (spawn / steer / abort / natural end), the `demi agent`
  * command tree, child shell environments, and the `subagent*` protocol frames
- * on the parent connection. Children are in-memory only: no store, no
- * checkpoint, gone with the parent.
+ * on the parent connection. Children persist exactly like the parent: each
+ * live child keeps a checkpoint and job record under the parent's session
+ * directory, and reopening the parent restores and resumes them (`restore`).
+ * A closed child leaves nothing behind.
  */
 declare class ChildSupervisor<State = unknown> {
   private readonly options;
@@ -380,9 +384,29 @@ declare class ChildSupervisor<State = unknown> {
   } | null;
   /** Re-emits `subagent started` + transcript reset for every running child (transcript resync). */
   replay(): void;
+  /**
+   * Detaches every live child on connection teardown: aborts in-flight turns,
+   * flushes checkpoints, and keeps the persisted job so the next open of this
+   * parent restores it — the same dispose semantics as the parent session.
+   * No `closed` frame is emitted: the children are not done, just paused.
+   */
   dispose(): Promise<void>;
+  /**
+   * Rebuilds every persisted live child of this parent and finishes what it was
+   * doing: an interrupted turn resumes from its resume point; an already
+   * quiescent child closes with its result. Children share the parent's
+   * persistence lifecycle — a parent restore is a child restore.
+   */
+  restore(): Promise<void>;
+  private restoreJob;
   abortSubtree(id: string): Promise<void>;
   private spawn;
+  /** Everything spawn and restore share: the command tree, the harness runtime, and the job record (session attached separately). */
+  private assembleJob;
+  private attachSession;
+  private childStoreKey;
+  private childSessionStore;
+  private deletePersistedJob;
   /** Delivers one steer to a child: mid-turn as a steer, idle as a new user turn. */
   private steerChild;
   private pumpStdinSteers;
@@ -392,6 +416,7 @@ declare class ChildSupervisor<State = unknown> {
   /** Resolves when the child is idle with no pending yield wakeups (or the job closed). */
   private waitForQuiescence;
   private closeJob;
+  private disposeJobShells;
   /** Wakes an idle parent with a user send; a parent blocked in the spawn gets the tool result instead. */
   private notifyIdleParent;
   private createChildAgentNode;

package/dist/index.mjs

@@ -2660,8 +2660,10 @@ const SPAWN_PROMPT_DESCRIPTION = "The child's first user message and only task b
 * Per-parent subagent supervisor. Owns every child `AgentSession` this parent
 * spawns: lifecycle (spawn / steer / abort / natural end), the `demi agent`
 * command tree, child shell environments, and the `subagent*` protocol frames
-* on the parent connection. Children are in-memory only: no store, no
-* checkpoint, gone with the parent.
+* on the parent connection. Children persist exactly like the parent: each
+* live child keeps a checkpoint and job record under the parent's session
+* directory, and reopening the parent restores and resumes them (`restore`).
+* A closed child leaves nothing behind.
 */
 var ChildSupervisor = class {
 	options;
@@ -2860,9 +2862,70 @@ var ChildSupervisor = class {
 			});
 		}
 	}
+	/**
+	* Detaches every live child on connection teardown: aborts in-flight turns,
+	* flushes checkpoints, and keeps the persisted job so the next open of this
+	* parent restores it — the same dispose semantics as the parent session.
+	* No `closed` frame is emitted: the children are not done, just paused.
+	*/
 	async dispose() {
 		this.isDisposed = true;
-		for (const job of [...this.jobs.values()]) await this.closeJob(job, "aborted");
+		for (const job of [...this.jobs.values()]) {
+			job.isClosing = true;
+			job.unsubscribe();
+			this.jobs.delete(job.id);
+			await job.session.dispose().catch(noop);
+			await this.disposeJobShells(job);
+			job.settleClosed({ phase: "aborted" });
+		}
+	}
+	/**
+	* Rebuilds every persisted live child of this parent and finishes what it was
+	* doing: an interrupted turn resumes from its resume point; an already
+	* quiescent child closes with its result. Children share the parent's
+	* persistence lifecycle — a parent restore is a child restore.
+	*/
+	async restore() {
+		const parent = this.parentSession;
+		if (!parent || this.isDisposed) return;
+		const prefix = `agent-sessions/${parent.id()}/subagents/`;
+		const keys = await this.options.store.list(prefix).catch(() => []);
+		const ids = [...new Set(keys.map((key) => key.slice(prefix.length).split("/")[0] ?? "").filter(Boolean))];
+		for (const id of ids) {
+			if (this.jobs.has(id)) continue;
+			try {
+				await this.restoreJob(id);
+			} catch {
+				await this.deletePersistedJob(id);
+			}
+		}
+	}
+	async restoreJob(id) {
+		const parent = this.parentSession;
+		if (!parent) return;
+		const meta = await this.options.store.readJson(this.childStoreKey(id, "job.json"));
+		const checkpoint = await this.childSessionStore(id).loadCheckpoint();
+		if (!meta || !checkpoint) throw new Error("incomplete persisted subagent");
+		const profile = this.resolveProfile(meta.profileName ?? void 0);
+		const { job, runtime } = this.assembleJob({
+			id,
+			description: meta.description,
+			profileName: meta.profileName,
+			profile,
+			metadata: meta.metadata,
+			spawnedAt: meta.spawnedAt
+		});
+		const session = AgentSession.fromCheckpoint({
+			provider: parent.cloneProviderRuntime(),
+			runtime,
+			checkpoint
+		}, {
+			agentSessionId: id,
+			store: this.childSessionStore(id),
+			...this.options.sessionOptions
+		});
+		this.attachSession(job, session);
+		this.watchTurn(job, session.resume(meta.metadata ? { metadata: meta.metadata } : {}));
 	}
 	async abortSubtree(id) {
 		const job = this.jobs.get(id);
@@ -2877,6 +2940,40 @@ var ChildSupervisor = class {
 		const profile = this.resolveProfile(input.profileName);
 		const id = createId();
 		const metadata = parent.actionMetadata();
+		const profileName = input.profileName ?? (this.options.profiles ? profile.name : null);
+		const spawnedAt = Date.now();
+		const { job, runtime } = this.assembleJob({
+			id,
+			description: input.description,
+			profileName,
+			profile,
+			metadata,
+			spawnedAt
+		});
+		await this.options.store.writeJson(this.childStoreKey(id, "job.json"), {
+			description: input.description,
+			profileName,
+			metadata,
+			spawnedAt
+		});
+		const session = new AgentSession({
+			provider: parent.cloneProviderRuntime(),
+			model: profile.model ?? structuredClone(parent.modelSelection),
+			cwd: this.options.cwd,
+			runtime,
+			state: this.options.agent.initialState()
+		}, {
+			agentSessionId: id,
+			store: this.childSessionStore(id),
+			...this.options.sessionOptions
+		});
+		this.attachSession(job, session);
+		this.watchChild(job, input.prompt);
+		return job;
+	}
+	/** Everything spawn and restore share: the command tree, the harness runtime, and the job record (session attached separately). */
+	assembleJob(input) {
+		const { id, profile } = input;
 		const agentNode = this.createChildAgentNode(id, input.description);
 		const commands = injectSubagentCommand(profile.commands ? profile.commands([...this.options.parentCommands]) : [...this.options.parentCommands], agentNode);
 		const commandRegistry = new CommandRegistry();
@@ -2891,15 +2988,15 @@ var ChildSupervisor = class {
 			id,
 			description: input.description,
 			profile,
-			profileName: input.profileName ?? (this.options.profiles ? profile.name : null),
-			metadata,
+			profileName: input.profileName,
+			metadata: input.metadata,
 			session: null,
 			commandRegistry,
 			commandNames,
 			environments: /* @__PURE__ */ new Map(),
 			pendingEnvironments: /* @__PURE__ */ new Map(),
 			readonlyHosts: /* @__PURE__ */ new WeakMap(),
-			spawnedAt: Date.now(),
+			spawnedAt: input.spawnedAt,
 			lastEventAt: Date.now(),
 			tools: [],
 			lastAssistantTextAt: null,
@@ -2912,56 +3009,64 @@ var ChildSupervisor = class {
 		};
 		const agent = this.options.agent;
 		const preamble = this.subagentPreamble(id);
-		const runtime = {
-			harnessName: agent.name,
-			initialState: () => agent.initialState(),
-			systemPrompt: (ctx) => (profile.systemPrompt ?? agent.systemPrompt).call(agent, {
-				...ctx,
-				commandsPrompt
-			}),
-			preamble: async (ctx) => {
-				const inheritedPreamble = profile.systemPrompt ? null : await agent.preamble?.(ctx) ?? null;
-				return inheritedPreamble ? `${inheritedPreamble}\n\n${preamble}` : preamble;
-			},
-			tools: () => createStandardAgentTools({
-				environment: (ctx) => this.childEnvironment(job, ctx),
-				scheduleYield: (ctx, durationMs) => job.session.scheduleYieldWakeup(durationMs, ctx.metadata)
-			})
+		return {
+			job,
+			runtime: {
+				harnessName: agent.name,
+				initialState: () => agent.initialState(),
+				systemPrompt: (ctx) => (profile.systemPrompt ?? agent.systemPrompt).call(agent, {
+					...ctx,
+					commandsPrompt
+				}),
+				preamble: async (ctx) => {
+					const inheritedPreamble = profile.systemPrompt ? null : await agent.preamble?.(ctx) ?? null;
+					return inheritedPreamble ? `${inheritedPreamble}\n\n${preamble}` : preamble;
+				},
+				tools: () => createStandardAgentTools({
+					environment: (ctx) => this.childEnvironment(job, ctx),
+					scheduleYield: (ctx, durationMs) => job.session.scheduleYieldWakeup(durationMs, ctx.metadata)
+				})
+			}
 		};
-		job.session = new AgentSession({
-			provider: parent.cloneProviderRuntime(),
-			model: profile.model ?? structuredClone(parent.modelSelection),
-			cwd: this.options.cwd,
-			runtime,
-			state: agent.initialState()
-		}, {
-			agentSessionId: id,
-			...this.options.sessionOptions
-		});
-		job.unsubscribe = job.session.subscribe((event) => {
+	}
+	attachSession(job, session) {
+		job.session = session;
+		job.unsubscribe = session.subscribe((event) => {
 			if (event.type !== "transcript_changed") return;
 			this.recordTelemetry(job, event.patches);
 			this.options.emit({
 				type: "subagent_transcript_patch",
-				subagentId: id,
+				subagentId: job.id,
 				patches: event.patches,
 				revision: event.revision
 			});
 		});
-		this.jobs.set(id, job);
+		this.jobs.set(job.id, job);
 		this.options.emit({
 			type: "subagent",
 			event: "started",
 			job: this.wireJob(job)
 		});
+		const transcript = session.transcript();
 		this.options.emit({
 			type: "subagent_transcript_reset",
-			subagentId: id,
-			blocks: [],
-			revision: 0
+			subagentId: job.id,
+			blocks: structuredClone(transcript.blocks),
+			revision: transcript.revision
 		});
-		this.watchChild(job, input.prompt);
-		return job;
+	}
+	childStoreKey(childId, file) {
+		return `agent-sessions/${this.parentSession?.id() ?? ""}/subagents/${childId}/${file}`;
+	}
+	childSessionStore(childId) {
+		return {
+			saveCheckpoint: (checkpoint) => this.options.store.writeJson(this.childStoreKey(childId, "checkpoint.json"), checkpoint),
+			loadCheckpoint: () => this.options.store.readJson(this.childStoreKey(childId, "checkpoint.json"))
+		};
+	}
+	async deletePersistedJob(id) {
+		await this.options.store.delete(this.childStoreKey(id, "checkpoint.json")).catch(noop);
+		await this.options.store.delete(this.childStoreKey(id, "job.json")).catch(noop);
 	}
 	/** Delivers one steer to a child: mid-turn as a steer, idle as a new user turn. */
 	async steerChild(job, message) {
@@ -3028,12 +3133,8 @@ var ChildSupervisor = class {
 		this.jobs.delete(job.id);
 		const result = phase === "completed" ? boundedResultText(lastAssistantText(job.session.transcript().blocks)) : void 0;
 		await job.session.dispose().catch(noop);
-		const environments = /* @__PURE__ */ new Set([...job.environments.values()]);
-		for (const pending of job.pendingEnvironments.values()) {
-			const environment = await pending.catch(() => null);
-			if (environment) environments.add(environment);
-		}
-		for (const environment of environments) await environment.disposeAllShells().catch(noop);
+		await this.disposeJobShells(job);
+		await this.deletePersistedJob(job.id);
 		const close = {
 			phase,
 			...result !== void 0 ? { result } : {},
@@ -3047,6 +3148,14 @@ var ChildSupervisor = class {
 		job.settleClosed(close);
 		this.notifyIdleParent(job, close);
 	}
+	async disposeJobShells(job) {
+		const environments = /* @__PURE__ */ new Set([...job.environments.values()]);
+		for (const pending of job.pendingEnvironments.values()) {
+			const environment = await pending.catch(() => null);
+			if (environment) environments.add(environment);
+		}
+		for (const environment of environments) await environment.disposeAllShells().catch(noop);
+	}
 	/** Wakes an idle parent with a user send; a parent blocked in the spawn gets the tool result instead. */
 	notifyIdleParent(job, close) {
 		if (this.isDisposed || !this.options.notifyParentOnIdle) return;
@@ -3308,6 +3417,7 @@ var ChildSupervisor = class {
 			description: job.description,
 			profile: job.profileName,
 			phase: job.phase,
+			metadata: job.metadata,
 			...result !== void 0 ? { result } : {}
 		};
 	}
@@ -3738,10 +3848,11 @@ var AgentTransportBindingImpl = class {
 		await this.sessions.claim(agentSessionId, this);
 		this.currentSessionId = agentSessionId;
 		const initialState = agent.initialState();
-		const store = new HostAgentSessionStore((await agent.host({
+		const provisionalHost = await agent.host({
 			state: initialState,
 			cwd: frame.cwd
-		})).store, agentSessionId);
+		});
+		const store = new HostAgentSessionStore(provisionalHost.store, agentSessionId);
 		const checkpoint = await store.loadCheckpoint();
 		const restoring = checkpoint !== null && checkpoint.harnessName === agent.name;
 		const state = restoring ? structuredClone(checkpoint.state) : initialState;
@@ -3760,6 +3871,7 @@ var AgentTransportBindingImpl = class {
 			prepareShell: this.prepareShell,
 			sessionOptions: this.sessionOptions,
 			notifyParentOnIdle: this.notifyParentOnIdle,
+			store: provisionalHost.store,
 			emit: (subagentFrame) => this.send(subagentFrame)
 		});
 		const commands = injectSubagentCommand(harnessCommands, supervisor.rootCommandNode());
@@ -3830,6 +3942,7 @@ var AgentTransportBindingImpl = class {
 			type: "queue",
 			queue: this.session.queuedMessages()
 		});
+		if (restoring) await supervisor.restore();
 	}
 	sendTranscriptReset(session) {
 		const transcript = session.transcript();

package/dist/stdio-transport.d.mts

@@ -1,4 +1,4 @@
-import { n as AgentServerTransport, t as AgentClientTransport } from "./transport-BRqZoaeo.mjs";
+import { n as AgentServerTransport, t as AgentClientTransport } from "./transport-CHrPzcrU.mjs";
 import { Readable, Writable } from "node:stream";
 //#region src/stdio-transport.d.ts
 declare function createStdioClientTransport(readable: Readable, writable: Writable): AgentClientTransport;

package/dist/{transport-BRqZoaeo.d.mts → transport-CHrPzcrU.d.mts}

@@ -398,6 +398,8 @@ interface SubagentJob {
   description: string;
   profile: string | null;
   phase: 'running' | 'completed' | 'aborted' | 'error';
+  /** Action metadata of the round that spawned the child. */
+  metadata: AgentMetadata | null;
   /** Present on `closed`: the child's last assistant text, at most 32 KiB. */
   result?: string;
 }

package/dist/{websocket-transport-C6Y5CeLG.d.mts → websocket-transport-NZ5Btmb4.d.mts}

@@ -1,4 +1,4 @@
-import { I as ModelSwitchApply, c as ConversationSummary, n as AgentServerTransport, p as AbortResult, s as ClientSessionEvent, t as AgentClientTransport, x as AgentMetadata } from "./transport-BRqZoaeo.mjs";
+import { I as ModelSwitchApply, c as ConversationSummary, n as AgentServerTransport, p as AbortResult, s as ClientSessionEvent, t as AgentClientTransport, x as AgentMetadata } from "./transport-CHrPzcrU.mjs";
 import { ProviderSelection } from "@demicodes/provider";
 import { Block, UserContentBlock } from "@demicodes/core";
 //#region src/client.d.ts

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@demicodes/agent",
   "description": "Session runtime and transport-neutral client and server protocol for Demi.",
-  "version": "0.19.1",
+  "version": "0.19.2",
   "private": false,
   "type": "module",
   "exports": {
@@ -19,10 +19,10 @@
     }
   },
   "dependencies": {
-    "@demicodes/core": "^0.19.1",
-    "@demicodes/provider": "^0.19.1",
-    "@demicodes/shell": "^0.19.1",
-    "@demicodes/utils": "^0.19.1",
+    "@demicodes/core": "^0.19.2",
+    "@demicodes/provider": "^0.19.2",
+    "@demicodes/shell": "^0.19.2",
+    "@demicodes/utils": "^0.19.2",
     "zod": "^4.0.0"
   },
   "license": "Apache-2.0",