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

package/README.md

@@ -78,6 +78,14 @@ Retained native sessions currently require `kind: 'host'`.
 The provider rejects a sandbox default before it creates the retained session; use one-shot execution for `kind: 'sandbox'`.
 The Bridge currently refuses `netJail` with `kind: 'sandbox'`; use the sandbox's own egress policy.
 
+### Native workspace cwd
+
+CLI Bridge accepts `workspace.cwd` only when its `base` is `"host"`.
+Its `path` is a native host process directory, so it may be absolute or empty.
+The adapter rejects a repository-based cwd before it sends a Bridge request.
+Tangle Sandbox accepts `workspace.cwd` with `base: "repository"` and a portable POSIX path.
+The capability document reports these supported cwd bases under `workspace.cwdBases`.
+
 Passing the same `sessionId` on later turns continues the same CLI conversation while the creating process still holds the environment.
 `executionId` gives a turn stable bridge identity, and `lastEventId` reattaches after a reader failure.
 `dispatch()` starts a bridge-owned durable run and returns after detaching its HTTP reader.
@@ -85,6 +93,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/capability-discovery.js

@@ -147,6 +147,11 @@ export function narrowCliBridgeCapabilities(adapter, reported, selectedBackend,
             git: false,
             upload: false,
             download: false,
+            // Host cwd support belongs to this adapter's process transport. The
+            // remote backend document does not own or describe that path.
+            ...(adapter.workspace.cwdBases === undefined
+                ? {}
+                : { cwdBases: adapter.workspace.cwdBases }),
         },
         branching: { checkpoint: false, fork: false },
         placement: adapter.placement && reported.placement,

package/dist/index.js

@@ -1,5 +1,5 @@
 import { agentEnvironmentCreateInputDigest, createAgentEnvironmentWithIdempotency, } from "@tangle-network/agent-interface/environment-provider";
-import { harnessTypeSchema, harnessSystemPromptIntents, snapshotAgentProfile, } from "@tangle-network/agent-interface";
+import { harnessTypeSchema, harnessSystemPromptIntents, snapshotAgentProfile, WorkspaceRequestSchema, workspaceCwdPathForBase, } from "@tangle-network/agent-interface";
 import { createCliBridgeEnvironment, } from "./retained-environment.js";
 import { lookupExactCliBridgeRun, } from "./retained-control.js";
 import { cachedCliBridgeCapabilityDiscovery, narrowCliBridgeCapabilities, } from "./capability-discovery.js";
@@ -57,10 +57,15 @@ export function createCliBridgeProvider(options) {
         if (typeof input.profile === "string") {
             throw new Error(`createCliBridgeProvider requires an inline AgentProfile; named profile "${input.profile}" is unsupported`);
         }
+        const workspace = input.workspace === undefined
+            ? undefined
+            : WorkspaceRequestSchema.parse(input.workspace);
+        workspaceCwdPathForBase(workspace?.cwd, "host", "CLI Bridge");
         const profile = snapshotAgentProfile(input.profile);
         const environmentInput = {
             ...input,
             profile,
+            ...(workspace === undefined ? {} : { workspace }),
         };
         const selectedBackend = selectedBackendFromInput(environmentInput, configuredBackend);
         const hasEnvironmentModel = selectedBackend !== undefined ||
@@ -225,6 +230,7 @@ export function defaultCliBridgeCapabilities(harness) {
             git: false,
             upload: false,
             download: false,
+            cwdBases: { repository: false, host: true },
         },
         branching: { checkpoint: false, fork: false },
         placement: true,

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/dist/wire.js

@@ -1,8 +1,9 @@
 import { createHash } from "node:crypto";
-import { AgentExactRunControlRefSchema, RequestedInteractionsSchema, } from "@tangle-network/agent-interface";
+import { AgentExactRunControlRefSchema, RequestedInteractionsSchema, WorkspaceRequestSchema, workspaceCwdPathForBase, } from "@tangle-network/agent-interface";
 export function toChatCompletionsBody(options, environmentInput, turn, coordinates) {
     const profile = inlineProfile(environmentInput.profile);
     const execution = executionFromInput(options, environmentInput);
+    const workspaceCwd = bridgeWorkspaceCwd(environmentInput);
     const interactions = turn.interactions === undefined
         ? undefined
         : RequestedInteractionsSchema.parse(turn.interactions);
@@ -21,7 +22,7 @@ export function toChatCompletionsBody(options, environmentInput, turn, coordinat
             ? { effort: profile.model.reasoningEffort }
             : {}),
         ...(environmentInput.env ? { env: environmentInput.env } : {}),
-        ...(environmentInput.workspace?.cwd ? { cwd: environmentInput.workspace.cwd } : {}),
+        ...(workspaceCwd === undefined ? {} : { cwd: workspaceCwd }),
         ...(execution ? { execution } : {}),
         ...(interactions === undefined ? {} : { interactions }),
         ...(turn.contextTransfer === undefined
@@ -55,14 +56,13 @@ export function resolveBridgeModel(options, environmentInput, turn, profile) {
 }
 export function toRetainedSessionBody(options, environmentInput, profile, sessionId, model) {
     const execution = retainedExecutionFromInput(options, environmentInput);
+    const workspaceCwd = bridgeWorkspaceCwd(environmentInput);
     return {
         id: sessionId,
         model,
         interaction_policy: "interactive",
         ...(options.defaultMode ? { mode: options.defaultMode } : {}),
-        ...(environmentInput.workspace?.cwd !== undefined
-            ? { cwd: environmentInput.workspace.cwd }
-            : {}),
+        ...(workspaceCwd === undefined ? {} : { cwd: workspaceCwd }),
         ...(execution !== undefined ? { execution } : {}),
         ...(profile ? { agent_profile: profile } : {}),
         ...(environmentInput.env !== undefined ? { env: environmentInput.env } : {}),
@@ -176,6 +176,12 @@ function retainedExecutionFromInput(options, input) {
     }
     return execution;
 }
+function bridgeWorkspaceCwd(input) {
+    const workspace = input.workspace === undefined
+        ? undefined
+        : WorkspaceRequestSchema.parse(input.workspace);
+    return workspaceCwdPathForBase(workspace?.cwd, "host", "CLI Bridge");
+}
 export async function* parseSse(body) {
     const decoder = new TextDecoder();
     let buffer = "";

package/package.json

@@ -1,9 +1,12 @@
 {
   "name": "@tangle-network/agent-provider-cli-bridge",
-  "version": "0.11.0",
+  "version": "1.0.0",
   "description": "AgentEnvironmentProvider adapter for cli-bridge retained sessions and one-shot turns",
   "type": "module",
   "license": "MIT",
+  "engines": {
+    "node": ">=22.19.0"
+  },
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
   "exports": {
@@ -61,8 +64,8 @@
     "LICENSE"
   ],
   "dependencies": {
-    "@tangle-network/agent-interface": "^1.9.0",
-    "undici": "7.29.0"
+    "@tangle-network/agent-interface": "^2.0.0",
+    "undici": "8.10.0"
   },
   "devDependencies": {
     "@types/node": "26.4.0",
@@ -74,6 +77,6 @@
     "check-types": "tsc --noEmit",
     "clean": "rm -rf dist",
     "test": "vitest run src",
-    "test:integration": "test -n \"$CLI_BRIDGE_INTEGRATION_ROOT\" || { echo 'CLI_BRIDGE_INTEGRATION_ROOT is required; see README' >&2; exit 1; }; vitest run tests/cli-bridge.integration.test.ts"
+    "test:integration": "test -n \"$CLI_BRIDGE_INTEGRATION_ROOT\" || { echo 'CLI_BRIDGE_INTEGRATION_ROOT is required; see README' >&2; exit 1; }; pnpm run build && vitest run tests/cli-bridge.integration.test.ts"
   }
 }