@demicodes/agent 0.12.0 → 0.14.0

package/README.md

@@ -2,21 +2,30 @@
 
 The session runtime and transport-neutral client/server protocol for Demi. It
 owns a turn's lifecycle — queueing, provider streaming, tool execution, steering,
-compaction, abort, and yield wakeups — and exposes it through an `AgentClient`
-that the REPL and web UI both consume.
+compaction, abort, resume recovery, and yield wakeups — and exposes it through an
+`AgentClient` that the REPL and web UI both consume.
 
 - `AgentServer` — owns sessions; `server.client()` returns an in-process client.
-- `AgentClient` — `open` / `send` / `steer` / `abort` / `close` / `subscribe`.
-- Transports: in-process, stdio (`@demicodes/agent/stdio`), or WebSocket.
+- `AgentClient` — `open` / `send` / `steer` / `resume` / `abort` / `close` /
+  `subscribe` / `listConversations`.
+- `AgentSession.clone()` — isolated point-in-time session copies (compaction and
+  forks); see [docs/provider-session-clone.md](../../docs/provider-session-clone.md).
+- Transports: in-process, stdio (`@demicodes/agent/stdio`), or WebSocket
+  (`createWebSocketClientTransport` from the root entry).
 - Actions accept caller-defined `metadata` that is available to harness and
-  tool contexts without becoming transcript or provider content.
+  tool contexts without becoming transcript or provider content
+  ([docs/action-metadata.md](../../docs/action-metadata.md)).
 
 ```ts
 import { AgentServer } from '@demicodes/agent'
 
 const server = new AgentServer({ agent, providers })
 const client = server.client()
+await client.open(selection, cwd, sessionId)
 ```
 
+`sessionId` is caller-owned and required so a conversation is never silently
+un-resumable.
+
 See [Embed the UI](../../docs/guides/embed-the-ui.md). Part of
 [Demi](../../README.md). Apache-2.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-Diegnou1.mjs";
-import { a as AgentClient, i as AgentActionOptions, n as createWebSocketClientTransport, o as AgentClientListener, r as createWebSocketServerTransport, t as JsonWebSocket } from "./websocket-transport-c4hu2c0X.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-gkyOzXn-.mjs";
+import { a as AgentClient, i as AgentActionOptions, n as createWebSocketClientTransport, o as AgentClientListener, r as createWebSocketServerTransport, t as JsonWebSocket } from "./websocket-transport-C6bu3Ufc.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,5 +1,5 @@
-import { A as AgentTool, B as TranscriptOptions, C as AgentSessionCheckpoint, D as AgentSessionRestoreParams, E as AgentSessionParams, F as SessionEvent, G as resolveRetryPolicy, H as DEFAULT_TURN_RETRY_POLICY, I as SessionEventListener, K as retryDelayMs, L as CompactionWindow, M as AgentToolInvokeContext, N as AgentToolInvokeResult, O as AgentSessionStore, P as ExternalMutationReservation, R as DrainedTranscriptPatches, S as AgentReferenceResolveContext, T as AgentSessionOptions, U as TurnRetryPolicy, V as estimateTranscriptBlockTokens, W as isRetryableCode, _ 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 AgentToolContext, k as AgentSystemPromptContext, 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 AgentSessionCloneParams, x as AgentPromptContext, y as AgentLifecycleEvent, z as TranscriptLog } from "./transport-Diegnou1.mjs";
-import { a as AgentClient, i as AgentActionOptions, n as createWebSocketClientTransport, o as AgentClientListener, r as createWebSocketServerTransport, t as JsonWebSocket } from "./websocket-transport-c4hu2c0X.mjs";
+import { A as AgentTool, B as TranscriptOptions, C as AgentSessionCheckpoint, D as AgentSessionRestoreParams, E as AgentSessionParams, F as SessionEvent, G as resolveRetryPolicy, H as DEFAULT_TURN_RETRY_POLICY, I as SessionEventListener, K as retryDelayMs, L as CompactionWindow, M as AgentToolInvokeContext, N as AgentToolInvokeResult, O as AgentSessionStore, P as ExternalMutationReservation, R as DrainedTranscriptPatches, S as AgentReferenceResolveContext, T as AgentSessionOptions, U as TurnRetryPolicy, V as estimateTranscriptBlockTokens, W as isRetryableCode, _ 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 AgentToolContext, k as AgentSystemPromptContext, 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 AgentSessionCloneParams, x as AgentPromptContext, y as AgentLifecycleEvent, z as TranscriptLog } from "./transport-gkyOzXn-.mjs";
+import { a as AgentClient, i as AgentActionOptions, n as createWebSocketClientTransport, o as AgentClientListener, r as createWebSocketServerTransport, t as JsonWebSocket } from "./websocket-transport-C6bu3Ufc.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";

package/dist/index.mjs

@@ -972,7 +972,7 @@ var ProviderTurnLoop = class {
 		}
 	}
 	async streamAttempt(attempt, policy) {
-		const request = this.buildInferenceRequest();
+		const request = await this.buildInferenceRequest();
 		const attemptStart = this.host.transcript.blocks.length;
 		const run = this.host.provider.run(request);
 		let shouldAutoRecover = false;
@@ -1121,14 +1121,15 @@ var ProviderTurnLoop = class {
 			metadata: this.host.metadata
 		});
 	}
-	buildInferenceRequest() {
+	async buildInferenceRequest() {
 		const tools = this.currentTools().map(toToolDefinition);
+		const systemPrompt = await this.host.runtime.systemPrompt(this.host.promptContext());
 		return {
 			sessionId: this.host.agentSessionId,
 			turnId: this.host.currentTurnId(),
 			requestId: this.host.nextRequestId(),
 			modelId: this.host.model.model.id,
-			systemPrompt: this.host.runtime.systemPrompt(this.host.promptContext()),
+			systemPrompt,
 			cwd: this.host.cwd,
 			items: this.host.transcript.collectInferenceItems(),
 			tools,
@@ -1873,7 +1874,7 @@ var AgentSession = class AgentSession {
 		});
 		const resolvedContent = await this.resolveReferences(content);
 		await this.applyPendingModelSwitch();
-		const preamble = hidden ? null : this.runtime.preamble?.(this.promptContext()) ?? null;
+		const preamble = hidden ? null : await this.runtime.preamble?.(this.promptContext()) ?? null;
 		this.transcriptLog.pushUserTurn(this.currentTurnId(), this.model, resolvedContent, preamble, hidden);
 		await this.commitTranscript();
 		await this.compaction.preflight();
@@ -2909,7 +2910,7 @@ var AgentTransportBindingImpl = class {
 			state,
 			cwd: frame.cwd
 		};
-		const commands = agent.commands?.(harnessContext) ?? [];
+		const commands = await agent.commands?.(harnessContext) ?? [];
 		const commandRegistry = new CommandRegistry();
 		for (const command of commands) commandRegistry.register(command);
 		const commandNames = commandRegistry.list().map((command) => command.name);

package/dist/stdio-transport.d.mts

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

package/dist/{transport-Diegnou1.d.mts → transport-gkyOzXn-.d.mts}

@@ -185,9 +185,9 @@ interface AgentHarness<State = unknown> {
   initialState(): State;
   /** Return the same Host object for calls that target the same execution environment. */
   host(ctx: AgentHarnessContext<State> | AgentHostContext<State>): Host | Promise<Host>;
-  commands?(ctx: AgentHarnessContext<State>): Command[];
-  systemPrompt(ctx: AgentSystemPromptContext<State>): string;
-  preamble?(ctx: AgentPromptContext<State>): string | null;
+  commands?(ctx: AgentHarnessContext<State>): Promise<Command[]> | Command[];
+  systemPrompt(ctx: AgentSystemPromptContext<State>): Promise<string> | string;
+  preamble?(ctx: AgentPromptContext<State>): Promise<string | null> | string | null;
   resolveReferences?(ctx: AgentReferenceResolveContext<State>, content: UserContentBlock[]): Promise<UserContentBlock[]> | UserContentBlock[];
   lifecycle?(event: AgentLifecycleEvent<State>): Promise<void> | void;
   dispose?(ctx: AgentDisposeContext<State>): Promise<void> | void;
@@ -245,8 +245,8 @@ type AgentLifecycleEvent<State> = {
 interface AgentHarnessRuntime<State> {
   harnessName: string;
   initialState(): State;
-  systemPrompt(ctx: AgentPromptContext<State>): string;
-  preamble?(ctx: AgentPromptContext<State>): string | null;
+  systemPrompt(ctx: AgentPromptContext<State>): Promise<string> | string;
+  preamble?(ctx: AgentPromptContext<State>): Promise<string | null> | string | null;
   resolveReferences?(ctx: AgentReferenceResolveContext<State>, content: UserContentBlock[]): Promise<UserContentBlock[]> | UserContentBlock[];
   tools(ctx: AgentToolContext<State>): AgentTool<State>[];
   lifecycle?(event: AgentLifecycleEvent<State>): Promise<void> | void;

package/dist/{websocket-transport-c4hu2c0X.d.mts → websocket-transport-C6bu3Ufc.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-Diegnou1.mjs";
+import { b as AgentMetadata, c as ConversationSummary, f as AbortResult, n as AgentServerTransport, s as ClientSessionEvent, t as AgentClientTransport } from "./transport-gkyOzXn-.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.12.0",
+  "version": "0.14.0",
   "private": false,
   "type": "module",
   "exports": {
@@ -19,10 +19,10 @@
     }
   },
   "dependencies": {
-    "@demicodes/core": "^0.12.0",
-    "@demicodes/provider": "^0.12.0",
-    "@demicodes/shell": "^0.12.0",
-    "@demicodes/utils": "^0.12.0"
+    "@demicodes/core": "^0.14.0",
+    "@demicodes/provider": "^0.14.0",
+    "@demicodes/shell": "^0.14.0",
+    "@demicodes/utils": "^0.14.0"
   },
   "license": "Apache-2.0",
   "main": "./dist/index.mjs",