@demicodes/agent 0.19.3 → 0.21.0

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-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 { 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-_eV2zg9M.mjs";
+import { a as AgentClient, i as AgentActionOptions, n as createWebSocketClientTransport, o as AgentClientListener, r as createWebSocketServerTransport, t as JsonWebSocket } from "./websocket-transport-BC7OstFf.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/client-entry.mjs

@@ -1,2 +1,2 @@
-import { n as createWebSocketServerTransport, r as AgentClient, t as createWebSocketClientTransport } from "./websocket-transport-CIOotpd-.mjs";
+import { n as createWebSocketServerTransport, r as AgentClient, t as createWebSocketClientTransport } from "./websocket-transport-BsKvbXIp.mjs";
 export { AgentClient, createWebSocketClientTransport, createWebSocketServerTransport };

package/dist/index.d.mts

@@ -1,5 +1,5 @@
-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 { 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-_eV2zg9M.mjs";
+import { a as AgentClient, i as AgentActionOptions, n as createWebSocketClientTransport, o as AgentClientListener, r as createWebSocketServerTransport, t as JsonWebSocket } from "./websocket-transport-BC7OstFf.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";
@@ -414,6 +414,8 @@ declare class ChildSupervisor<State = unknown> {
   private listArchivedJobs;
   private pruneArchive;
   abortSubtree(id: string): Promise<void>;
+  /** Aborts every live child; the archive is untouched. */
+  abortAll(): Promise<void>;
   private spawn;
   /** Everything spawn and restore share: the command tree, the harness runtime, and the job record (session attached separately). */
   private assembleJob;

package/dist/index.mjs

@@ -1,4 +1,4 @@
-import { a as cloneBlocks, i as applyTranscriptPatches, n as createWebSocketServerTransport, o as ProviderStreamError, r as AgentClient, s as isContextLengthExceeded, t as createWebSocketClientTransport } from "./websocket-transport-CIOotpd-.mjs";
+import { a as cloneBlocks, i as applyTranscriptPatches, n as createWebSocketServerTransport, o as ProviderStreamError, r as AgentClient, s as isContextLengthExceeded, t as createWebSocketClientTransport } from "./websocket-transport-BsKvbXIp.mjs";
 import { AbortError, abortable, asError, asRecord, asString, bytesToBase64, createId, decodeUtf8, delay, errorMessage, isAbortError, isRecord, noop, parseJsonOrString, safeJsonStringify, sliceHead, sliceTail, throwIfAborted, toWellFormedText, truncate, utf8Slice } from "@demicodes/utils";
 import { BashEnvironment, CommandRegistry, MAX_TIMEOUT_MS, heredocDelimiter, shellQuote } from "@demicodes/shell";
 import { providerRuntime } from "@demicodes/provider";
@@ -2597,7 +2597,7 @@ function formatShellToolResult(result, options) {
 		lines.push(`metaPath: ${result.artifactDir}/meta.json`);
 	}
 	if (options.includePreview) appendPreview(lines, result, options.previewBudgetTokens ?? SMALL_CONTEXT_PREVIEW_TOKENS);
-	if (result.status === "running") lines.push("next: command is still running; check again with shell_status, or call yield to end this turn and be woken later, or shell_abort to stop it.");
+	if (result.status === "running") lines.push(result.runningHint ?? "next: command is still running; check again with shell_status, or call yield to end this turn and be woken later, or shell_abort to stop it.");
 	else if (result.status === "aborted") lines.push("next: command was intentionally stopped.");
 	else if (exposeCommandHandle) lines.push("next: command is complete; read the artifact only if the preview is insufficient.");
 	return lines.join("\n");
@@ -2656,6 +2656,7 @@ const MAX_LIVE_SUBAGENTS = 8;
 const MAX_ARCHIVED_SUBAGENTS = 16;
 const SUBAGENT_RESULT_MAX_BYTES = 32768;
 const SHOW_RECENT_TOOLS = 8;
+const SPAWN_RUNNING_HINT = "next: the child agent is still working; a long-running spawn is normal. shell_write steers it, shell_abort aborts it. Otherwise stop attending and end the turn — the child's completion returns as this command's result and wakes the session when it is idle. Do not poll with shell_status or timed yields; use `demi agent show` only to decide a steer or abort.";
 const SPAWN_PROMPT_DESCRIPTION = "The child's first user message and only task brief. The child starts with an empty transcript and cannot see this conversation: do not refer to prior turns, and do not paste this conversation or the product user's message unchanged. Include the goal for this child, applicable decisions and constraints, whether to edit or only report, how to verify, and every concrete identifier it needs (paths, ids, error text, commands already tried and their key results). State the exact shape of the last assistant text it should return.";
 /**
 * Per-parent subagent supervisor. Owns every child `AgentSession` this parent
@@ -2683,7 +2684,7 @@ var ChildSupervisor = class {
 		const profileNames = this.configuredProfileNames();
 		return {
 			name: "agent",
-			summary: "Start an isolated child agent session and wait for its result. The command stays running until the child session ends; stdout is the child's last assistant text. While it is the foreground job, shell_write steers the child and shell_abort aborts it. Run several in separate shell_exec calls with short timeoutMs to fan out.",
+			summary: "Start an isolated child agent session and wait for its result. The command stays running until the child session ends; stdout is the child's last assistant text. While it is the foreground job, shell_write steers the child and shell_abort aborts it. Run several in separate shell_exec calls with short timeoutMs to fan out, then end the turn — completion wakes an idle session; do not poll.",
 			successOutput: "first stderr line is \"subagentId: <id>\" at start; stdout is the child's last assistant text (empty is valid), written only at exit",
 			failureOutput: "non-zero exit with the abort or failure reason on stderr",
 			input: {
@@ -2697,6 +2698,7 @@ var ChildSupervisor = class {
 				subagentId: z.string(),
 				text: z.string()
 			}) },
+			runningHint: SPAWN_RUNNING_HINT,
 			run: async ({ parsed, io, signal, stdinStream }) => {
 				const prompt = String(parsed.values.prompt ?? "").trim();
 				if (!prompt) {
@@ -2791,6 +2793,7 @@ var ChildSupervisor = class {
 						subagentId: z.string(),
 						text: z.string()
 					}) },
+					runningHint: SPAWN_RUNNING_HINT,
 					run: async ({ parsed, io, signal, stdinStream }) => {
 						const id = String(parsed.values.id);
 						const message = String(parsed.values.message ?? "").trim();
@@ -3027,6 +3030,10 @@ var ChildSupervisor = class {
 		if (!job) return;
 		await this.closeJob(job, "aborted");
 	}
+	/** Aborts every live child; the archive is untouched. */
+	async abortAll() {
+		for (const id of [...this.jobs.keys()]) await this.abortSubtree(id);
+	}
 	async spawn(input) {
 		const parent = this.parentSession;
 		if (!parent) throw new Error("subagent supervisor has no parent session");
@@ -3942,6 +3949,9 @@ var AgentTransportBindingImpl = class {
 					});
 					return;
 				}
+				case "abort_subagents":
+					await this.supervisor?.abortAll();
+					return;
 				case "shell_write":
 					await this.handleShellWrite(frame);
 					return;

package/dist/stdio-transport.d.mts

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

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

@@ -438,6 +438,8 @@ type ClientFrame = {
   apply?: ModelSwitchApply;
 } | {
   type: 'abort';
+} | {
+  type: 'abort_subagents';
 } | {
   type: 'retry';
   metadata?: AgentMetadata;

package/dist/{websocket-transport-NZ5Btmb4.d.mts → websocket-transport-BC7OstFf.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-CHrPzcrU.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-_eV2zg9M.mjs";
 import { ProviderSelection } from "@demicodes/provider";
 import { Block, UserContentBlock } from "@demicodes/core";
 //#region src/client.d.ts
@@ -59,6 +59,12 @@ declare class AgentClient {
   resume(options?: AgentActionOptions): Promise<void>;
   compact(options?: AgentActionOptions): Promise<void>;
   abort(): Promise<AbortResult>;
+  /**
+   * Aborts every live child agent of this session (the archive is untouched).
+   * Fire-and-forget: each child settles through its own `subagent closed`
+   * frame with phase 'aborted'.
+   */
+  abortSubagents(): void;
   shellWrite(commandId: string, stdin: string, options?: AgentActionOptions): Promise<void>;
   close(): Promise<void>;
   subscribe(listener: AgentClientListener): () => void;

package/dist/{websocket-transport-CIOotpd-.mjs → websocket-transport-BsKvbXIp.mjs}

@@ -209,6 +209,14 @@ var AgentClient = class {
 		this.sendFrame({ type: "abort" });
 		return wait;
 	}
+	/**
+	* Aborts every live child agent of this session (the archive is untouched).
+	* Fire-and-forget: each child settles through its own `subagent closed`
+	* frame with phase 'aborted'.
+	*/
+	abortSubagents() {
+		this.sendFrame({ type: "abort_subagents" });
+	}
 	shellWrite(commandId, stdin, options = {}) {
 		const wait = this.waitForShellWrite(commandId);
 		this.sendFrame({

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.3",
+  "version": "0.21.0",
   "private": false,
   "type": "module",
   "exports": {
@@ -19,10 +19,10 @@
     }
   },
   "dependencies": {
-    "@demicodes/core": "^0.19.3",
-    "@demicodes/provider": "^0.19.3",
-    "@demicodes/shell": "^0.19.3",
-    "@demicodes/utils": "^0.19.3",
+    "@demicodes/core": "^0.21.0",
+    "@demicodes/provider": "^0.21.0",
+    "@demicodes/shell": "^0.21.0",
+    "@demicodes/utils": "^0.21.0",
     "zod": "^4.0.0"
   },
   "license": "Apache-2.0",