@demicodes/agent 0.9.1 → 0.10.0

package/dist/client-entry.d.mts

@@ -1,4 +1,4 @@
-import { b as AgentMetadata, d as TranscriptPatch, l as ServerFrame, n as AgentServerTransport, o as ClientFrame, r as AgentTransport, s as ClientSessionEvent, t as AgentClientTransport, u as ShellCommandStatusLike } from "./transport-CD53ZgRO.mjs";
-import { a as AgentClient, i as AgentActionOptions, n as createWebSocketClientTransport, o as AgentClientListener, r as createWebSocketServerTransport, t as JsonWebSocket } from "./websocket-transport-DrsdY12Z.mjs";
+import { b as AgentMetadata, d as TranscriptPatch, l as ServerFrame, n as AgentServerTransport, o as ClientFrame, r as AgentTransport, s as ClientSessionEvent, t as AgentClientTransport, u as ShellCommandStatusLike } from "./transport-BZwi2YZL.mjs";
+import { a as AgentClient, i as AgentActionOptions, n as createWebSocketClientTransport, o as AgentClientListener, r as createWebSocketServerTransport, t as JsonWebSocket } from "./websocket-transport-CZpGt4Py.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-D8o_MJP4.mjs";
+import { n as createWebSocketServerTransport, r as AgentClient, t as createWebSocketClientTransport } from "./websocket-transport-os0mfcLi.mjs";
 export { AgentClient, createWebSocketClientTransport, createWebSocketServerTransport };

package/dist/index.d.mts

@@ -1,8 +1,30 @@
-import { A as AgentToolContext, B as estimateTranscriptBlockTokens, C as AgentSessionCheckpoint, D as AgentSessionStore, E as AgentSessionRestoreParams, F as SessionEventListener, G as retryDelayMs, H as TurnRetryPolicy, I as CompactionWindow, L as DrainedTranscriptPatches, M as AgentToolInvokeResult, N as ExternalMutationReservation, O as AgentSystemPromptContext, P as SessionEvent, R as TranscriptLog, S as AgentReferenceResolveContext, T as AgentSessionParams, U as isRetryableCode, V as DEFAULT_TURN_RETRY_POLICY, W as resolveRetryPolicy, _ as AgentHarnessRuntime, a as createInProcessTransportPair, b as AgentMetadata, c as ConversationSummary, d as TranscriptPatch, f as AbortResult, g as AgentHarnessContext, h as AgentHarness, i as InProcessTransportPair, j as AgentToolInvokeContext, k as AgentTool, l as ServerFrame, m as AgentDisposeContext, n as AgentServerTransport, o as ClientFrame, p as AbortTarget, r as AgentTransport, s as ClientSessionEvent, t as AgentClientTransport, u as ShellCommandStatusLike, v as AgentHostContext, w as AgentSessionOptions, x as AgentPromptContext, y as AgentLifecycleEvent, z as TranscriptOptions } from "./transport-CD53ZgRO.mjs";
-import { a as AgentClient, i as AgentActionOptions, n as createWebSocketClientTransport, o as AgentClientListener, r as createWebSocketServerTransport, t as JsonWebSocket } from "./websocket-transport-DrsdY12Z.mjs";
+import { A as AgentToolContext, B as estimateTranscriptBlockTokens, C as AgentSessionCheckpoint, D as AgentSessionStore, E as AgentSessionRestoreParams, F as SessionEventListener, G as retryDelayMs, H as TurnRetryPolicy, I as CompactionWindow, L as DrainedTranscriptPatches, M as AgentToolInvokeResult, N as ExternalMutationReservation, O as AgentSystemPromptContext, P as SessionEvent, R as TranscriptLog, S as AgentReferenceResolveContext, T as AgentSessionParams, U as isRetryableCode, V as DEFAULT_TURN_RETRY_POLICY, W as resolveRetryPolicy, _ as AgentHarnessRuntime, a as createInProcessTransportPair, b as AgentMetadata, c as ConversationSummary, d as TranscriptPatch, f as AbortResult, g as AgentHarnessContext, h as AgentHarness, i as InProcessTransportPair, j as AgentToolInvokeContext, k as AgentTool, l as ServerFrame, m as AgentDisposeContext, n as AgentServerTransport, o as ClientFrame, p as AbortTarget, r as AgentTransport, s as ClientSessionEvent, t as AgentClientTransport, u as ShellCommandStatusLike, v as AgentHostContext, w as AgentSessionOptions, x as AgentPromptContext, y as AgentLifecycleEvent, z as TranscriptOptions } from "./transport-BZwi2YZL.mjs";
+import { a as AgentClient, i as AgentActionOptions, n as createWebSocketClientTransport, o as AgentClientListener, r as createWebSocketServerTransport, t as JsonWebSocket } from "./websocket-transport-CZpGt4Py.mjs";
 import { BashAuditEvent, BashEnvironment, BashEnvironmentOptions, CommandMetadataRecord, Host, 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
+/**
+ * Where re-inference must restart after a turn failed to finish.
+ *
+ * `cut` is the index from which blocks are discardable; `isFullRerun` is true when
+ * that reaches all the way back to the user turn, meaning the turn produced nothing
+ * and can simply be run again.
+ */
+interface ResumePoint {
+  cut: number;
+  isFullRerun: boolean;
+}
+/**
+ * Finds how far back an unfinished turn can be unwound before re-inferring.
+ *
+ * This is the single decision behind both recovery paths. A transient provider
+ * failure and a human asking to continue a dead round ask the same question — how
+ * do we finish this turn — and the answer depends only on what has already left
+ * the process, never on which of the two asked or on how the turn died.
+ */
+declare function findResumePoint(blocks: readonly Block[]): ResumePoint;
+//#endregion
 //#region src/provider-stream-error.d.ts
 /** Error carrying a provider stream's normalized code and bounded diagnostics. */
 declare class ProviderStreamError extends Error {
@@ -62,10 +84,24 @@ declare class AgentSession<State> {
     id?: string;
     metadata?: AgentMetadata;
   }): Promise<void>;
+  /**
+   * Discards the whole latest turn and runs it again from the user's input.
+   *
+   * This is "regenerate": it is only meaningful when the caller wants a different
+   * answer to the same question and knows the turn's effects can be repeated. It is
+   * NOT the way to recover a failed turn — use `resume`, which unwinds only as far
+   * as is safe.
+   */
   retry(options?: {
     metadata?: AgentMetadata;
   }): Promise<void>;
-  /** Continues from the current transcript after an abort or terminal provider error. */
+  /**
+   * Finishes a turn that did not finish, after an abort or a terminal provider
+   * error. Unwinds to the turn's resume point — dropping the failed attempt's
+   * leftovers, keeping everything that already left the process — and re-infers
+   * from there. Callers do not choose the granularity and do not need to know how
+   * the turn died.
+   */
   resume(options?: {
     metadata?: AgentMetadata;
   }): Promise<void>;
@@ -135,6 +171,13 @@ declare class AgentSession<State> {
   private executeSend;
   private resolveReferences;
   private executeRetry;
+  /**
+   * Finishes an unfinished turn. Unwinds to its resume point — dropping the failed
+   * attempt's leftovers, keeping everything that already left the process — and
+   * re-infers from there. When the whole turn turns out to be discardable this is
+   * a plain rerun, which spares the model a continuation boundary attached to a
+   * stub of its own aborted output.
+   */
   private executeResume;
   private providerEvents;
   private promptContext;
@@ -322,4 +365,4 @@ interface ShellToolView {
 declare function finishShellToolResult<State>(environment: BashEnvironment, result: ShellCommandStatus, ctx: AgentToolInvokeContext<State>): Promise<AgentToolInvokeResult>;
 declare function shellCommandHandleRequired(result: ShellCommandStatus, budgetTokens: number): boolean;
 //#endregion
-export { AbortResult, AbortTarget, ActiveTurnPhase, AgentActionOptions, AgentClient, AgentClientListener, AgentClientTransport, AgentDisposeContext, AgentHarness, AgentHarnessContext, AgentHarnessRuntime, AgentHostContext, AgentLifecycleEvent, AgentMetadata, AgentPromptContext, AgentReferenceResolveContext, AgentServer, AgentServerOptions, AgentServerSessionOptions, AgentServerTransport, AgentSession, AgentSessionCheckpoint, AgentSessionOptions, AgentSessionParams, AgentSessionRestoreParams, AgentSessionStore, AgentSystemPromptContext, AgentTool, AgentToolContext, AgentToolInvokeContext, AgentToolInvokeResult, AgentTransport, AgentTransportBinding, ClientFrame, ClientSessionEvent, CompactionWindow, ConversationSummary, DEFAULT_MAX_MEDIA_BYTES, DEFAULT_TURN_RETRY_POLICY, DrainedTranscriptPatches, ExternalMutationReservation, InProcessTransportPair, JsonWebSocket, PrepareShell, PrepareShellContext, ProviderStreamError, RunCommandLineCommandNotRegisteredError, RunCommandLineOptions, RunCommandLineResult, RunCommandLineShellNotFoundError, RunCommandLineTimeoutError, SHELL_VIEW_MAX_CHARS, ServerFrame, SessionEvent, SessionEventListener, ShellCommandStatusLike, ShellToolResultOptions, ShellToolView, StandardAgentToolOptions, TranscriptLog, TranscriptOptions, TranscriptPatch, TurnRetryPolicy, applyTranscriptPatches, cloneBlocks, createInProcessTransportPair, createStandardAgentTools, createWebSocketClientTransport, createWebSocketServerTransport, estimateTranscriptBlockTokens, finishShellToolResult, isContextLengthExceeded, isRetryableCode, resolveRetryPolicy, retryDelayMs, shellCommandHandleRequired, shellPreviewBudgetTokens, toShellToolResult };
+export { AbortResult, AbortTarget, ActiveTurnPhase, AgentActionOptions, AgentClient, AgentClientListener, AgentClientTransport, AgentDisposeContext, AgentHarness, AgentHarnessContext, AgentHarnessRuntime, AgentHostContext, AgentLifecycleEvent, AgentMetadata, AgentPromptContext, AgentReferenceResolveContext, AgentServer, AgentServerOptions, AgentServerSessionOptions, AgentServerTransport, AgentSession, AgentSessionCheckpoint, AgentSessionOptions, AgentSessionParams, AgentSessionRestoreParams, AgentSessionStore, AgentSystemPromptContext, AgentTool, AgentToolContext, AgentToolInvokeContext, AgentToolInvokeResult, AgentTransport, AgentTransportBinding, ClientFrame, ClientSessionEvent, CompactionWindow, ConversationSummary, DEFAULT_MAX_MEDIA_BYTES, DEFAULT_TURN_RETRY_POLICY, DrainedTranscriptPatches, ExternalMutationReservation, InProcessTransportPair, JsonWebSocket, PrepareShell, PrepareShellContext, ProviderStreamError, ResumePoint, RunCommandLineCommandNotRegisteredError, RunCommandLineOptions, RunCommandLineResult, RunCommandLineShellNotFoundError, RunCommandLineTimeoutError, SHELL_VIEW_MAX_CHARS, ServerFrame, SessionEvent, SessionEventListener, ShellCommandStatusLike, ShellToolResultOptions, ShellToolView, StandardAgentToolOptions, TranscriptLog, TranscriptOptions, TranscriptPatch, TurnRetryPolicy, applyTranscriptPatches, cloneBlocks, createInProcessTransportPair, createStandardAgentTools, createWebSocketClientTransport, createWebSocketServerTransport, estimateTranscriptBlockTokens, findResumePoint, finishShellToolResult, isContextLengthExceeded, isRetryableCode, resolveRetryPolicy, retryDelayMs, shellCommandHandleRequired, shellPreviewBudgetTokens, toShellToolResult };

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-D8o_MJP4.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-os0mfcLi.mjs";
 import { AbortError, abortable, asError, asRecord, asString, bytesToBase64, createId, delay, isAbortError, isRecord, noop, parseJsonOrString, safeJsonStringify, throwIfAborted, truncate } from "@demicodes/utils";
 import { BashEnvironment, CommandRegistry, MAX_TIMEOUT_MS, heredocDelimiter, shellQuote } from "@demicodes/shell";
 import { providerRuntime } from "@demicodes/provider";
@@ -149,6 +149,22 @@ var TranscriptLog = class {
 		}
 		return null;
 	}
+	/**
+	* Drops the blocks from `index` onward, returning true when anything went.
+	* Used to unwind a turn to its resume point before re-inferring.
+	*/
+	truncateFrom(index) {
+		let changed = false;
+		for (let i = this.blocks.length - 1; i >= index; i -= 1) {
+			this.blocks.splice(i, 1);
+			this.record({
+				op: "remove",
+				path: ["blocks", i]
+			});
+			changed = true;
+		}
+		return changed;
+	}
 	applyProviderEvent(model, event) {
 		switch (event.type) {
 			case "thinking_start": return this.appendThinking(model, "");
@@ -604,6 +620,57 @@ function retryDelayMs(policy, attempt, retryAfterMs) {
 	return Math.floor(Math.random() * ceiling);
 }
 //#endregion
+//#region src/recovery.ts
+/**
+* Whether a block is a leftover of the failed attempt that nobody can have acted on.
+*
+* Everything else has to be assumed acted on. Transcript blocks stream outward as
+* they are produced and products turn them into effects that cannot be recalled —
+* rendering them, posting them to a chat, executing the tool they describe. A tool
+* call counts whatever its status: one still marked executing outlived the process
+* that was running it, so whether its effect landed is unknown, and unknown has to
+* be treated as landed. An abort block is history the user created, not a leftover.
+*
+* Thinking is the interesting case: products display it, but nothing keys off it and
+* a rerun simply reasons again, so it is discardable. A `response` is not — it
+* records a provider request that did complete, and its usage anchors the context
+* estimate for everything after it.
+*/
+function isDiscardableLeftover(block) {
+	switch (block.type) {
+		case "thinking":
+		case "redacted_thinking":
+		case "error": return true;
+		case "text": return block.text.trim().length === 0;
+		default: return false;
+	}
+}
+/**
+* Finds how far back an unfinished turn can be unwound before re-inferring.
+*
+* This is the single decision behind both recovery paths. A transient provider
+* failure and a human asking to continue a dead round ask the same question — how
+* do we finish this turn — and the answer depends only on what has already left
+* the process, never on which of the two asked or on how the turn died.
+*/
+function findResumePoint(blocks) {
+	for (let i = blocks.length - 1; i >= 0; i -= 1) {
+		const block = blocks[i];
+		if (block.type === "user") return {
+			cut: i + 1,
+			isFullRerun: true
+		};
+		if (!isDiscardableLeftover(block)) return {
+			cut: i + 1,
+			isFullRerun: false
+		};
+	}
+	return {
+		cut: blocks.length,
+		isFullRerun: false
+	};
+}
+//#endregion
 //#region src/yield-scheduler.ts
 /**
 * Tracks scheduled `yield` wakeups and their timers. This class owns only the
@@ -944,8 +1011,9 @@ var ProviderTurnLoop = class {
 	}
 	/**
 	* Streams one provider response, silently retrying transient failures
-	* (rate_limit/overloaded) with backoff — but only while the attempt has
-	* produced no transcript content, so a retry can never duplicate output.
+	* (rate_limit/overloaded) with backoff. A retry is taken only when everything
+	* the failed attempt put in the transcript can be unwound — the same question
+	* `resume` asks, so an automatic recovery and a human-driven one never disagree.
 	* The turn stays in provider_streaming across backoff waits so steers keep
 	* queueing instead of being rejected.
 	*/
@@ -971,9 +1039,9 @@ var ProviderTurnLoop = class {
 	}
 	async streamAttempt(attempt, policy) {
 		const request = this.buildInferenceRequest();
+		const attemptStart = this.host.transcript.blocks.length;
 		const run = this.host.provider.run(request);
 		let shouldAutoRecover = false;
-		let produced = false;
 		let hasPendingThinkingStart = false;
 		this.host.setActiveProviderRun(run);
 		try {
@@ -994,13 +1062,16 @@ var ProviderTurnLoop = class {
 						...event,
 						diagnostics
 					};
-					if (!produced && attempt < policy.maxAttempts && isRetryableCode(policy, errorEvent.code)) return {
-						type: "retry",
-						attempt,
-						delayMs: retryDelayMs(policy, attempt, errorEvent.retryAfterMs ?? null),
-						code: errorEvent.code,
-						diagnostics: errorEvent.diagnostics
-					};
+					if (findResumePoint(this.host.transcript.blocks).cut <= attemptStart && attempt < policy.maxAttempts && isRetryableCode(policy, errorEvent.code)) {
+						if (this.host.transcript.truncateFrom(attemptStart)) await this.host.commitTranscript();
+						return {
+							type: "retry",
+							attempt,
+							delayMs: retryDelayMs(policy, attempt, errorEvent.retryAfterMs ?? null),
+							code: errorEvent.code,
+							diagnostics: errorEvent.diagnostics
+						};
+					}
 					await this.applyProviderEvent(errorEvent);
 					throw new ProviderStreamError(errorEvent.message, errorEvent.code, errorEvent.diagnostics);
 				}
@@ -1009,7 +1080,6 @@ var ProviderTurnLoop = class {
 					hasPendingThinkingStart = false;
 				}
 				await this.applyProviderEvent(event);
-				produced = true;
 				if (event.type === "response" && this.isUsageNearLimit(event.usage)) shouldAutoRecover = true;
 			}
 		} finally {
@@ -1337,6 +1407,14 @@ var AgentSession = class AgentSession {
 			reject: noop
 		});
 	}
+	/**
+	* Discards the whole latest turn and runs it again from the user's input.
+	*
+	* This is "regenerate": it is only meaningful when the caller wants a different
+	* answer to the same question and knows the turn's effects can be repeated. It is
+	* NOT the way to recover a failed turn — use `resume`, which unwinds only as far
+	* as is safe.
+	*/
 	retry(options = {}) {
 		return this.enqueue({
 			type: "retry",
@@ -1345,7 +1423,13 @@ var AgentSession = class AgentSession {
 			reject: noop
 		});
 	}
-	/** Continues from the current transcript after an abort or terminal provider error. */
+	/**
+	* Finishes a turn that did not finish, after an abort or a terminal provider
+	* error. Unwinds to the turn's resume point — dropping the failed attempt's
+	* leftovers, keeping everything that already left the process — and re-infers
+	* from there. Callers do not choose the granularity and do not need to know how
+	* the turn died.
+	*/
 	resume(options = {}) {
 		return this.enqueue({
 			type: "resume",
@@ -1878,8 +1962,21 @@ var AgentSession = class AgentSession {
 		await this.compaction.preflight();
 		await this.turnLoop.run();
 	}
+	/**
+	* Finishes an unfinished turn. Unwinds to its resume point — dropping the failed
+	* attempt's leftovers, keeping everything that already left the process — and
+	* re-infers from there. When the whole turn turns out to be discardable this is
+	* a plain rerun, which spares the model a continuation boundary attached to a
+	* stub of its own aborted output.
+	*/
 	async executeResume() {
+		const { cut, isFullRerun } = findResumePoint(this.transcriptLog.blocks);
+		if (isFullRerun) {
+			await this.executeRetry();
+			return;
+		}
 		await this.applyPendingModelSwitch();
+		this.transcriptLog.truncateFrom(cut);
 		this.transcriptLog.markLatestAbortResumed();
 		this.transcriptLog.pushResumeTurn(this.currentTurnId(), this.model);
 		await this.commitTranscript();
@@ -3339,4 +3436,4 @@ function createProviderMap(providers) {
 	return map;
 }
 //#endregion
-export { AgentClient, AgentServer, AgentSession, DEFAULT_MAX_MEDIA_BYTES, DEFAULT_TURN_RETRY_POLICY, ProviderStreamError, RunCommandLineCommandNotRegisteredError, RunCommandLineShellNotFoundError, RunCommandLineTimeoutError, SHELL_VIEW_MAX_CHARS, TranscriptLog, applyTranscriptPatches, cloneBlocks, createInProcessTransportPair, createStandardAgentTools, createWebSocketClientTransport, createWebSocketServerTransport, estimateTranscriptBlockTokens, finishShellToolResult, isContextLengthExceeded, isRetryableCode, resolveRetryPolicy, retryDelayMs, shellCommandHandleRequired, shellPreviewBudgetTokens, toShellToolResult };
+export { AgentClient, AgentServer, AgentSession, DEFAULT_MAX_MEDIA_BYTES, DEFAULT_TURN_RETRY_POLICY, ProviderStreamError, RunCommandLineCommandNotRegisteredError, RunCommandLineShellNotFoundError, RunCommandLineTimeoutError, SHELL_VIEW_MAX_CHARS, TranscriptLog, applyTranscriptPatches, cloneBlocks, createInProcessTransportPair, createStandardAgentTools, createWebSocketClientTransport, createWebSocketServerTransport, estimateTranscriptBlockTokens, findResumePoint, finishShellToolResult, isContextLengthExceeded, isRetryableCode, resolveRetryPolicy, retryDelayMs, shellCommandHandleRequired, shellPreviewBudgetTokens, toShellToolResult };

package/dist/stdio-transport.d.mts

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

package/dist/{transport-CD53ZgRO.d.mts → transport-BZwi2YZL.d.mts}

@@ -83,6 +83,11 @@ declare class TranscriptLog implements Transcript {
   rewindToLastUserTurn(): Extract<Block, {
     type: 'user';
   }> | null;
+  /**
+   * Drops the blocks from `index` onward, returning true when anything went.
+   * Used to unwind a turn to its resume point before re-inferring.
+   */
+  truncateFrom(index: number): boolean;
   applyProviderEvent(model: ModelSelection, event: ProviderEvent): Block | null;
   completeToolCall(toolUseId: string, output: ToolResultContentBlock[], isError?: boolean, view?: unknown | null): Block | null;
   findPendingToolUseId(): string | null;

package/dist/{websocket-transport-DrsdY12Z.d.mts → websocket-transport-CZpGt4Py.d.mts}

@@ -1,4 +1,4 @@
-import { b as AgentMetadata, c as ConversationSummary, f as AbortResult, n as AgentServerTransport, s as ClientSessionEvent, t as AgentClientTransport } from "./transport-CD53ZgRO.mjs";
+import { b as AgentMetadata, c as ConversationSummary, f as AbortResult, n as AgentServerTransport, s as ClientSessionEvent, t as AgentClientTransport } from "./transport-BZwi2YZL.mjs";
 import { ProviderSelection } from "@demicodes/provider";
 import { Block, UserContentBlock } from "@demicodes/core";
 //#region src/client.d.ts
@@ -39,8 +39,18 @@ declare class AgentClient {
    * turn (the server applies it at a turn boundary), so this is fire-and-forget.
    */
   setProvider(provider: ProviderSelection): void;
+  /**
+   * Discards the whole latest turn and runs it again from the user's input —
+   * "regenerate". NOT a recovery path: it drops text the turn already emitted and
+   * tool calls it already ran while their effects remain. Use `resume` to finish a
+   * turn that failed.
+   */
   retry(options?: AgentActionOptions): Promise<void>;
-  /** Continues from the current transcript after an abort or terminal provider error. */
+  /**
+   * Finishes a turn that did not finish, after an abort or a terminal provider
+   * error. Unwinds only as far as is safe and re-infers from there; the caller
+   * does not choose the granularity.
+   */
   resume(options?: AgentActionOptions): Promise<void>;
   compact(options?: AgentActionOptions): Promise<void>;
   abort(): Promise<AbortResult>;

package/dist/{websocket-transport-D8o_MJP4.mjs → websocket-transport-os0mfcLi.mjs}

@@ -165,6 +165,12 @@ var AgentClient = class {
 			provider
 		});
 	}
+	/**
+	* Discards the whole latest turn and runs it again from the user's input —
+	* "regenerate". NOT a recovery path: it drops text the turn already emitted and
+	* tool calls it already ran while their effects remain. Use `resume` to finish a
+	* turn that failed.
+	*/
 	retry(options = {}) {
 		const wait = this.waitForAction("retry");
 		this.sendFrame({
@@ -173,7 +179,11 @@ var AgentClient = class {
 		});
 		return wait;
 	}
-	/** Continues from the current transcript after an abort or terminal provider error. */
+	/**
+	* Finishes a turn that did not finish, after an abort or a terminal provider
+	* error. Unwinds only as far as is safe and re-infers from there; the caller
+	* does not choose the granularity.
+	*/
 	resume(options = {}) {
 		const wait = this.waitForAction("resume");
 		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.9.1",
+  "version": "0.10.0",
   "private": false,
   "type": "module",
   "exports": {
@@ -19,10 +19,10 @@
     }
   },
   "dependencies": {
-    "@demicodes/core": "^0.9.1",
-    "@demicodes/provider": "^0.9.1",
-    "@demicodes/shell": "^0.9.1",
-    "@demicodes/utils": "^0.9.1"
+    "@demicodes/core": "^0.10.0",
+    "@demicodes/provider": "^0.10.0",
+    "@demicodes/shell": "^0.10.0",
+    "@demicodes/utils": "^0.10.0"
   },
   "license": "Apache-2.0",
   "main": "./dist/index.mjs",