@demicodes/agent 0.15.0 → 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;
 }

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;
 			},

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.15.0",
+  "version": "0.16.0",
   "private": false,
   "type": "module",
   "exports": {
@@ -19,10 +19,10 @@
     }
   },
   "dependencies": {
-    "@demicodes/core": "^0.15.0",
-    "@demicodes/provider": "^0.15.0",
-    "@demicodes/shell": "^0.15.0",
-    "@demicodes/utils": "^0.15.0"
+    "@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",