@demicodes/agent 0.14.2 → 0.16.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-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 { 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-CfvLnrq0.mjs";
+import { a as AgentClient, i as AgentActionOptions, n as createWebSocketClientTransport, o as AgentClientListener, r as createWebSocketServerTransport, t as JsonWebSocket } from "./websocket-transport-DkL4cjeV.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-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 { 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-CfvLnrq0.mjs";
+import { a as AgentClient, i as AgentActionOptions, n as createWebSocketClientTransport, o as AgentClientListener, r as createWebSocketServerTransport, t as JsonWebSocket } from "./websocket-transport-DkL4cjeV.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";
@@ -48,6 +48,7 @@ declare class AgentSession<State> {
   private readonly store?;
   private readonly compactionKeepRecentTokens;
   private readonly compactionThresholdRatio;
+  private readonly compactionThresholdTokens;
   private readonly listeners;
   private readonly pendingActions;
   private readonly queued;
@@ -231,6 +232,7 @@ interface AgentServerSessionOptions {
   compaction?: {
     keepRecentTokens?: number;
     preflightThresholdRatio?: number;
+    preflightThresholdTokens?: number;
   };
   persistIntervalMs?: number;
 }
@@ -352,7 +354,8 @@ declare function toShellToolResult(result: ShellCommandStatus, options?: ShellTo
 declare const SHELL_VIEW_MAX_CHARS = 32768;
 /**
  * Bounded UI view of a shell command stored on the tool_call block. Full
- * output lives in the command artifact (`/@/commands/<commandId>/…`), keyed by
+ * output lives in the command artifact directory (real files on the host
+ * filesystem, see `artifactDir`), keyed by
  * `commandId`; the view carries only the tail render window and never embeds
  * raw or base64 bytes.
  */

package/dist/index.mjs

@@ -793,6 +793,20 @@ var PendingSteerQueue = class {
 function estimateTokens(text) {
 	return Math.ceil(text.length / 4);
 }
+/**
+* Resolves the token count at which auto-compaction fires.
+*
+* - A non-finite `thresholdRatio` disables auto-compaction (used by summary clones).
+* - When `thresholdTokens` is a finite number, it is used as an absolute threshold,
+*   clamped to `[0, contextWindow]`.
+* - Otherwise the threshold is `floor(contextWindow * thresholdRatio)`.
+*/
+function resolveCompactionThreshold(contextWindow, thresholdRatio, thresholdTokens) {
+	if (contextWindow <= 0) return 0;
+	if (!Number.isFinite(thresholdRatio)) return Number.POSITIVE_INFINITY;
+	if (thresholdTokens != null && Number.isFinite(thresholdTokens)) return Math.min(Math.max(0, Math.floor(thresholdTokens)), contextWindow);
+	return Math.floor(contextWindow * thresholdRatio);
+}
 /** The next (smaller) cut point to retry compaction with, or null when nothing more can be compacted. */
 function nextSmallerCompactionCutPoint(startIndex, cutPoint) {
 	const compactedBlockCount = cutPoint - startIndex;
@@ -825,7 +839,7 @@ var CompactionController = class {
 	async compactToFit(targetModel) {
 		const contextWindow = targetModel.model.contextWindow;
 		if (contextWindow <= 0) return;
-		const threshold = Math.floor(contextWindow * this.host.thresholdRatio);
+		const threshold = resolveCompactionThreshold(contextWindow, this.host.thresholdRatio, this.host.thresholdTokens);
 		if (this.host.transcript.estimateContextTokens(contextWindow) < threshold) return;
 		await this.host.runWithCompactingPhase(async () => {
 			for (let attempt = 0; attempt < 8 && this.host.transcript.estimateContextTokens(contextWindow) >= threshold; attempt += 1) if (!await this.run()) break;
@@ -835,7 +849,7 @@ var CompactionController = class {
 	async preflight() {
 		const contextWindow = this.host.model.model.contextWindow;
 		if (contextWindow <= 0) return;
-		const threshold = Math.floor(contextWindow * this.host.thresholdRatio);
+		const threshold = resolveCompactionThreshold(contextWindow, this.host.thresholdRatio, this.host.thresholdTokens);
 		if (this.host.transcript.estimateContextTokens(contextWindow) < threshold) return;
 		await this.host.runWithCompactingPhase(() => this.run());
 	}
@@ -1146,7 +1160,7 @@ var ProviderTurnLoop = class {
 	isUsageNearLimit(usage) {
 		const contextWindow = this.host.model.model.contextWindow;
 		if (contextWindow <= 0) return false;
-		return usage.inputTokens + usage.outputTokens + usage.cacheReadTokens + usage.cacheWriteTokens >= Math.floor(contextWindow * this.host.thresholdRatio);
+		return usage.inputTokens + usage.outputTokens + usage.cacheReadTokens + usage.cacheWriteTokens >= resolveCompactionThreshold(contextWindow, this.host.thresholdRatio, this.host.thresholdTokens);
 	}
 };
 function toToolDefinition(tool) {
@@ -1172,6 +1186,7 @@ var AgentSession = class AgentSession {
 	store;
 	compactionKeepRecentTokens;
 	compactionThresholdRatio;
+	compactionThresholdTokens;
 	listeners = /* @__PURE__ */ new Set();
 	pendingActions = [];
 	queued = [];
@@ -1237,6 +1252,7 @@ var AgentSession = class AgentSession {
 		this.retryPolicy = resolveRetryPolicy(options.retry);
 		this.compactionKeepRecentTokens = options.compaction?.keepRecentTokens ?? DEFAULT_KEEP_RECENT_TOKENS;
 		this.compactionThresholdRatio = options.compaction?.preflightThresholdRatio ?? DEFAULT_PREFLIGHT_THRESHOLD_RATIO;
+		this.compactionThresholdTokens = options.compaction?.preflightThresholdTokens === void 0 ? null : options.compaction.preflightThresholdTokens;
 		const transcriptOptions = {
 			idFactory: this.idFactory,
 			now: options.now
@@ -1256,6 +1272,9 @@ var AgentSession = class AgentSession {
 			get thresholdRatio() {
 				return self.compactionThresholdRatio;
 			},
+			get thresholdTokens() {
+				return self.compactionThresholdTokens;
+			},
 			currentSignal: () => self.currentSignal(),
 			clone: (transcript) => self.clone({
 				transcript,
@@ -1294,6 +1313,9 @@ var AgentSession = class AgentSession {
 			get thresholdRatio() {
 				return self.compactionThresholdRatio;
 			},
+			get thresholdTokens() {
+				return self.compactionThresholdTokens;
+			},
 			get steerContinuationCount() {
 				return self.steerQueue.continuationCount;
 			},
@@ -2350,7 +2372,7 @@ function toShellToolResult(result, options = {}) {
 		text: formatShellToolResult(result, options)
 	}];
 	if (result.status === "exited" && result.binaryStdout) {
-		const verdict = binaryStreamVerdict(result.binaryStdout, result.commandId, options.model, {
+		const verdict = binaryStreamVerdict(result.binaryStdout, `${result.artifactDir}/stdout.bin`, options.model, {
 			...DEFAULT_MAX_MEDIA_BYTES,
 			...options.maxMediaBytes
 		});
@@ -2425,9 +2447,8 @@ function tailChunkWindow(chunks, maxChars) {
 * magic matches the closed model-media set, the model accepts the type, and
 * the stream was not truncated; otherwise explain why nothing was attached.
 */
-function binaryStreamVerdict(binary, commandId, model, maxMediaBytes) {
+function binaryStreamVerdict(binary, binPath, model, maxMediaBytes) {
 	const media = sniffModelMediaType(binary.data);
-	const binPath = `/@/commands/${commandId}/stdout.bin`;
 	if (binary.truncated) return { note: `Binary stdout (${binary.totalBytes} bytes${media ? `, ${media.mediaType}` : ""}) exceeded the shell's ${binary.limitBytes}-byte binary limit (maxBinaryBytes) and was not attached; the raw bytes remain readable at ${binPath}. Produce a smaller version and re-run.` };
 	if (!media) return { note: `Binary stdout does not match any model-viewable media type; the raw bytes remain readable at ${binPath}.` };
 	if (!model || !modelAcceptsMediaType(model, media.mediaType)) return { note: `Binary stdout is ${media.mediaType}, which this model does not accept natively; the raw bytes remain readable at ${binPath}.` };
@@ -2525,7 +2546,7 @@ function formatShellToolResult(result, options) {
 		lines.push(`idleMs: ${result.idleMs}`);
 		appendArtifact(lines, "stdout", result.stdout);
 		appendArtifact(lines, "stderr", result.stderr);
-		lines.push(`metaPath: /@/commands/${result.commandId}/meta.json`);
+		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.");
@@ -2546,7 +2567,7 @@ function appendPreview(lines, result, budgetTokens) {
 	}
 	lines.push("preview:");
 	lines.push(preview.text);
-	if (preview.truncated || result.output.truncated) lines.push(`previewTruncated: true; read /@/commands/${result.commandId}/stdout.txt or /@/commands/${result.commandId}/stderr.txt for more.`);
+	if (preview.truncated || result.output.truncated) lines.push(`previewTruncated: true; read ${result.artifactDir}/stdout.txt or ${result.artifactDir}/stderr.txt for more.`);
 }
 function boundedPreview(text, budgetTokens) {
 	const maxChars = Math.max(0, Math.floor(budgetTokens * APPROX_CHARS_PER_TOKEN));

package/dist/stdio-transport.d.mts

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

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

@@ -308,6 +308,12 @@ interface AgentSessionOptions<State = unknown> {
   compaction?: {
     keepRecentTokens?: number;
     preflightThresholdRatio?: number;
+    /**
+     * Absolute token threshold for auto-compaction. When set, replaces the
+     * ratio-derived threshold (still clamped to the model context window).
+     * A non-finite `preflightThresholdRatio` still disables auto-compaction.
+     */
+    preflightThresholdTokens?: number;
   };
   /**
    * Maximum interval between checkpoint writes while a turn is streaming. Writes

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