@tangle-network/agent-provider-cli-bridge 0.11.0 → 0.11.1

package/README.md

@@ -85,6 +85,8 @@ The returned `AgentSession` exposes status, cursor-based event replay, the termi
 Cancellation returns only after cli-bridge confirms the run is terminal.
 A direct stream treats a finish frame as provisional until cli-bridge returns the same run's aggregate result.
 A retained replay confirms its terminal state from the retained run endpoint.
+Terminal results retain the newest 1,024 events and preserve full text and usage totals.
+Use `session.events()` when a caller needs the complete retained event history.
 Retained native runs use canonical runtime envelopes and finish with a terminal status event.
 Pass any emitted event `id` back as `since` to resume after that event.
 The canonical envelope identity remains available as `event.data.eventId`.

package/dist/retained-execution.d.ts

@@ -1,4 +1,4 @@
-import type { TokenUsage } from "@tangle-network/agent-interface";
+import { type TokenUsage } from "@tangle-network/agent-interface";
 import type { AgentEnvironmentEvent, AgentSessionRef, AgentTurnResult, CreateAgentEnvironmentInput } from "@tangle-network/agent-interface/environment-provider";
 import type { CliBridgeProviderOptions } from "./provider-options.js";
 import { type CliBridgeRun, type CliBridgeSessionState, type PreparedCliBridgeRun } from "./retained-run-state.js";

package/dist/retained-execution.js

@@ -1,3 +1,4 @@
+import { AgentTurnResultSchema, } from "@tangle-network/agent-interface";
 import { cancelCliBridgeRun, captureCliBridgeRunIdentity, cliBridgeCancellationSignal, detachCliBridgeReader, getCliBridgeRun, } from "./retained-control.js";
 import { bindCliBridgeRun, bindCliBridgeSession, exactControlRefForRun, restoreCliBridgeRun, restoreCliBridgeSession, } from "./retained-run-state.js";
 import { CliBridgeRequestRejectedError, streamCliBridgeTurn, } from "./retained-stream.js";
@@ -5,6 +6,7 @@ import { beginCliBridgeNativeTurn, } from "./retained-native.js";
 import { MAX_CLI_BRIDGE_CONTROL_RESPONSE_BYTES, readBoundedCliBridgeResponse, requestHeaders, trimSlash, } from "./transport.js";
 import { modelRequestCount } from "./wire.js";
 import { lookupCliBridgeContext } from "./context-transfer.js";
+const MAX_CLI_BRIDGE_RESULT_EVENTS = 1_024;
 export async function* streamTrackedCliBridgeTurn(options, environmentInput, providerName, prepared, transport, runs, sessions, readers, nativeSessions, useNativeInteractions) {
     const originalTurn = prepared.turn;
     if (originalTurn.detach) {
@@ -252,6 +254,7 @@ function assertCanonicalEventBinding(event, run, providerName) {
 }
 export async function collectCliBridgeTurnResult(source, run, options, transport, signal) {
     const events = [];
+    let eventCount = 0;
     let text = "";
     let usage;
     let observedModelRequests = 0;
@@ -262,7 +265,11 @@ export async function collectCliBridgeTurnResult(source, run, options, transport
     let streamError;
     try {
         for await (const event of source) {
-            events.push(event);
+            if (eventCount < MAX_CLI_BRIDGE_RESULT_EVENTS)
+                events.push(event);
+            else
+                events[eventCount % MAX_CLI_BRIDGE_RESULT_EVENTS] = event;
+            eventCount += 1;
             const finalText = event.data.finalText;
             if (typeof finalText === "string") {
                 text = finalText;
@@ -307,7 +314,13 @@ export async function collectCliBridgeTurnResult(source, run, options, transport
         throw new Error(`cli-bridge run "${run.id}" has no terminal result`);
     }
     const success = snapshot.status === "done" && streamError === undefined;
-    return {
+    const resultEvents = eventCount <= MAX_CLI_BRIDGE_RESULT_EVENTS
+        ? events
+        : [
+            ...events.slice(eventCount % MAX_CLI_BRIDGE_RESULT_EVENTS),
+            ...events.slice(0, eventCount % MAX_CLI_BRIDGE_RESULT_EVENTS),
+        ];
+    return AgentTurnResultSchema.parse({
         text,
         success,
         ...(!success
@@ -335,8 +348,8 @@ export async function collectCliBridgeTurnResult(source, run, options, transport
             ...(servedModel === undefined ? {} : { model: servedModel }),
             ...(systemFingerprint === undefined ? {} : { system_fingerprint: systemFingerprint }),
         },
-        events,
-    };
+        events: resultEvents,
+    });
 }
 /** Keep reasoning and tool updates out of the assistant's visible result text. */
 export function visibleTextDelta(event) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tangle-network/agent-provider-cli-bridge",
-  "version": "0.11.0",
+  "version": "0.11.1",
   "description": "AgentEnvironmentProvider adapter for cli-bridge retained sessions and one-shot turns",
   "type": "module",
   "license": "MIT",