@tangle-network/sdk-provider-cli-base 0.13.1 → 0.13.3

package/dist/index.d.mts

@@ -891,9 +891,12 @@ declare function plaintextResponseParser<TEvent>(state: ExecutionState, onEvent:
 }): StreamParserConfig<TEvent>;
 //#endregion
 //#region src/execution-request-headers.d.ts
+declare const EXECUTION_ID_HEADER = "X-Tangle-Execution-ID";
 /** Router column that joins a model request to the turn trace that caused it. */
 declare const EXECUTION_TRACE_HEADER = "X-Tangle-Trace-ID";
 declare const MANAGED_QUOTE_VERSION_HEADER = "X-Tangle-Managed-Quote-Version";
+/** Every header a turn's correlation may set, lowercased. */
+declare const EXECUTION_CORRELATION_HEADERS: string[];
 /**
  * Capture diagnostic identity without forwarding caller-supplied transport headers.
  * `traceId` is the turn's trace id; a value no header can carry is omitted,
@@ -1244,5 +1247,5 @@ declare function homeXdgEnv(home: string): {
   XDG_STATE_HOME: string;
 };
 //#endregion
-export { ACP_MIN_PROTOCOL_VERSION, ACP_PROTOCOL_VERSION, AcpBridgeConfig, type AcpBridgeSpawn, AcpContentBlock, AcpInitializeParams, AcpInitializeResult, AcpNewSessionResult, type AcpProcessSpec, AcpPromptResult, AcpProviderAdapterBase, AcpSessionUpdateParams, AcpTurn, type AskUserBridge, CODEX_DISABLED_FEATURE_ARGS, CliExecArgs, CliExecutionInput, CliProviderAdapterBase, CliProviderConfig, CliProviderLogger, CliProviderOptions, type CliTurnProcess, type CliTurnSpawn, DEFAULT_INTERACTION_MCP_SERVER_NAME, EXECUTION_TRACE_HEADER, EphemeralContextInput, ExecutionState, type HarnessId, InteractionBroker, InteractionHttpBridge, InteractionMcpServer, InteractionMcpServerConfig, InteractionToggleConfig, InteractionToggleKind, InvalidAttachmentError, MANAGED_QUOTE_VERSION_HEADER, MAX_INLINE_IMAGE_BYTES, MAX_TOTAL_INLINE_IMAGE_BYTES, McpInteractionSupport, NATIVE_SESSION_CONTRACTS, PERMISSION_DECISION_TIMEOUT_MS, PROMPT_SECTION_SEPARATOR, PerTurnInteractionInput, type PermissionPromptBridge, PlaintextResponse, PreparedAttachment, type PreparedCliLaunch, RepeatedToolFailure, RepeatedToolFailureGuardOptions, type RequestPermissionBridge, type RequestPlanBridge, SEALED_NATIVE_HOME_LAYOUT, SECRET_REFERENCE, SECRET_REFERENCE_PREFIX, SecretProfileMcpCredentialProxy, SecretProfileMcpServer, SessionRehydrationError, TerminalPlanSupport, TerminalPlanSupportOptions, ToolCallState, TurnEndReason, type WorkspacePlanApplication, accumulateCliTokenUsage, acpContentText, assertSealedNativeHome, assertSealedNativeSearchPath, brokerInteractionTools, buildFileUrl, codexDeveloperInstructionArgs, createExecutionState, createRepeatedToolFailureGuard, deriveFilePart, deterministicFilePartId, enabledInteractionKinds, executionCorrelationHeaders, finalTextEvent, forgetSessionScopes, homeXdgEnv, inferMediaType, interactionMcpToolName, interactionToggleEnabled, isLocalMcpConfig, isLoopbackEndpoint, isPlainRecord, isTrustedStoreBinary, joinQueue, jsonEventParser, kimiThinkingArgs, localMcpArgv, localMcpEnv, nativeEffortArgs, parseCliUsageLine, partitionImageAttachments, plaintextResponseParser, preparePromptInputParts, prependPromptSection, provenStoreBinary, readCliTokenUsage, readEphemeralContext, reasoningEvents, recordCliTokenUsage, refuseSecretLaunch, rejectNotLaunched, requireRecord, resolveExecutableRealpath, resolveReferences, runtimeSecretsOverlay, secretMcpScope, secretSessionTurnQueue, servableMcpServer, servableStdioServer, sessionObservedEvents, spawnAcpBridge, streamPartBase, textDeltaEvents, textSnapshotEvents, toolResultEvents, toolStartEvents, trackFilePart, trackReasoningBlock, turnEndReason, turnInteractionEnabled, untilSettledOrAborted, wasNeverLaunched, withEphemeralContext, withTurnInteractions };
+export { ACP_MIN_PROTOCOL_VERSION, ACP_PROTOCOL_VERSION, AcpBridgeConfig, type AcpBridgeSpawn, AcpContentBlock, AcpInitializeParams, AcpInitializeResult, AcpNewSessionResult, type AcpProcessSpec, AcpPromptResult, AcpProviderAdapterBase, AcpSessionUpdateParams, AcpTurn, type AskUserBridge, CODEX_DISABLED_FEATURE_ARGS, CliExecArgs, CliExecutionInput, CliProviderAdapterBase, CliProviderConfig, CliProviderLogger, CliProviderOptions, type CliTurnProcess, type CliTurnSpawn, DEFAULT_INTERACTION_MCP_SERVER_NAME, EXECUTION_CORRELATION_HEADERS, EXECUTION_ID_HEADER, EXECUTION_TRACE_HEADER, EphemeralContextInput, ExecutionState, type HarnessId, InteractionBroker, InteractionHttpBridge, InteractionMcpServer, InteractionMcpServerConfig, InteractionToggleConfig, InteractionToggleKind, InvalidAttachmentError, MANAGED_QUOTE_VERSION_HEADER, MAX_INLINE_IMAGE_BYTES, MAX_TOTAL_INLINE_IMAGE_BYTES, McpInteractionSupport, NATIVE_SESSION_CONTRACTS, PERMISSION_DECISION_TIMEOUT_MS, PROMPT_SECTION_SEPARATOR, PerTurnInteractionInput, type PermissionPromptBridge, PlaintextResponse, PreparedAttachment, type PreparedCliLaunch, RepeatedToolFailure, RepeatedToolFailureGuardOptions, type RequestPermissionBridge, type RequestPlanBridge, SEALED_NATIVE_HOME_LAYOUT, SECRET_REFERENCE, SECRET_REFERENCE_PREFIX, SecretProfileMcpCredentialProxy, SecretProfileMcpServer, SessionRehydrationError, TerminalPlanSupport, TerminalPlanSupportOptions, ToolCallState, TurnEndReason, type WorkspacePlanApplication, accumulateCliTokenUsage, acpContentText, assertSealedNativeHome, assertSealedNativeSearchPath, brokerInteractionTools, buildFileUrl, codexDeveloperInstructionArgs, createExecutionState, createRepeatedToolFailureGuard, deriveFilePart, deterministicFilePartId, enabledInteractionKinds, executionCorrelationHeaders, finalTextEvent, forgetSessionScopes, homeXdgEnv, inferMediaType, interactionMcpToolName, interactionToggleEnabled, isLocalMcpConfig, isLoopbackEndpoint, isPlainRecord, isTrustedStoreBinary, joinQueue, jsonEventParser, kimiThinkingArgs, localMcpArgv, localMcpEnv, nativeEffortArgs, parseCliUsageLine, partitionImageAttachments, plaintextResponseParser, preparePromptInputParts, prependPromptSection, provenStoreBinary, readCliTokenUsage, readEphemeralContext, reasoningEvents, recordCliTokenUsage, refuseSecretLaunch, rejectNotLaunched, requireRecord, resolveExecutableRealpath, resolveReferences, runtimeSecretsOverlay, secretMcpScope, secretSessionTurnQueue, servableMcpServer, servableStdioServer, sessionObservedEvents, spawnAcpBridge, streamPartBase, textDeltaEvents, textSnapshotEvents, toolResultEvents, toolStartEvents, trackFilePart, trackReasoningBlock, turnEndReason, turnInteractionEnabled, untilSettledOrAborted, wasNeverLaunched, withEphemeralContext, withTurnInteractions };
 //# sourceMappingURL=index.d.mts.map

package/dist/index.mjs

@@ -13,6 +13,7 @@ import { execFile } from "node:child_process";
 import { isDeepStrictEqual, promisify } from "node:util";
 import { messageStorageDirOf } from "@tangle-network/cli-agent-registry";
 import { NATIVE_SESSION_CONTRACTS, NATIVE_SESSION_CONTRACTS as NATIVE_SESSION_CONTRACTS$1, configDirHomeEnv } from "@tangle-network/cli-agent-registry/native-session-contracts";
+import * as W3C from "@tangle-network/agent-trace-contract";
 import { z } from "zod";
 import { fileURLToPath, pathToFileURL } from "node:url";
 import { DatabaseSync } from "node:sqlite";
@@ -954,14 +955,22 @@ async function terminateTurnProcess(process, activeProcesses) {
 //#endregion
 //#region src/execution-request-headers.ts
 const headerValue = z.string().regex(/^[\x21-\x2b\x2d-\x7e]{1,256}$/);
+const EXECUTION_ID_HEADER = "X-Tangle-Execution-ID";
 const CORRELATION_FIELDS = {
 	"X-Tangle-Environment-ID": "environmentId",
 	"X-Tangle-Session-ID": "sessionId",
-	"X-Tangle-Execution-ID": "executionId"
+	[EXECUTION_ID_HEADER]: "executionId"
 };
 /** Router column that joins a model request to the turn trace that caused it. */
 const EXECUTION_TRACE_HEADER = "X-Tangle-Trace-ID";
 const MANAGED_QUOTE_VERSION_HEADER = "X-Tangle-Managed-Quote-Version";
+/** Every header a turn's correlation may set, lowercased. */
+const EXECUTION_CORRELATION_HEADERS = [
+	...Object.keys(CORRELATION_FIELDS),
+	EXECUTION_TRACE_HEADER,
+	MANAGED_QUOTE_VERSION_HEADER,
+	"traceparent"
+].map((name) => name.toLowerCase());
 const managedQuoteVersion = z.string().regex(/^mmq_[a-f0-9]{40}$/);
 /**
 * Capture diagnostic identity without forwarding caller-supplied transport headers.
@@ -969,12 +978,16 @@ const managedQuoteVersion = z.string().regex(/^mmq_[a-f0-9]{40}$/);
 * because a trace is diagnostic and must never refuse the run.
 */
 function executionCorrelationHeaders(binding, traceId, quoteVersion) {
-	const quote = quoteVersion === void 0 ? void 0 : managedQuoteVersion.parse(quoteVersion);
+	const quote = managedQuoteVersion.optional().parse(quoteVersion);
 	if (quote !== void 0 && binding === void 0) throw new Error("Managed quote requires an exact execution binding");
 	const trace = headerValue.safeParse(traceId);
-	const traced = trace.success ? { [EXECUTION_TRACE_HEADER]: trace.data } : {};
-	if (binding === void 0) return trace.success ? Object.freeze(traced) : void 0;
-	const headers = { ...traced };
+	const headers = {};
+	if (trace.success) {
+		headers[EXECUTION_TRACE_HEADER] = trace.data;
+		const span = W3C.toW3CSpanId(`${trace.data}:sidecar`);
+		headers.traceparent = `00-${W3C.toW3CTraceId(trace.data)}-${span}-01`;
+	}
+	if (binding === void 0) return trace.success ? Object.freeze(headers) : void 0;
 	if (quote !== void 0) headers[MANAGED_QUOTE_VERSION_HEADER] = quote;
 	for (const [name, field] of Object.entries(CORRELATION_FIELDS)) {
 		const value = headerValue.safeParse(binding[field]);
@@ -1526,7 +1539,7 @@ var CliAdapterProfile = class extends CliAdapterLifecycle {
 		}, toolBinDirs, [...parseSandboxToolBinDirs(env.SANDBOX_TOOL_BIN_DIRS), ...parseSandboxToolBinDirs(process.env.SANDBOX_TOOL_BIN_DIRS)]);
 	}
 	bindExecutionCorrelation(environment, correlationHeaders) {
-		if (correlationHeaders !== void 0 && Object.keys(correlationHeaders).some((name) => name !== "X-Tangle-Trace-ID")) this.logger.warn("Native model request correlation is unsupported", { provider: this.provider });
+		if (correlationHeaders?.["X-Tangle-Execution-ID"] !== void 0) this.logger.warn("Native model request correlation is unsupported", { provider: this.provider });
 		return environment;
 	}
 	/** Launcher controls this adapter OWNS on the spawn it starts — see `BINDABLE_LAUNCH_CONTROLS` in the materializer. */
@@ -3355,7 +3368,7 @@ var CliProviderAdapterBase = class extends CliAdapterMcp {
 			sessionId,
 			providerSessionId: options.providerSessionId,
 			executionSignal: input.abortSignal ?? new AbortController().signal,
-			correlationHeaders: executionCorrelationHeaders(input.interactionBinding, input.traceId, void 0),
+			correlationHeaders: executionCorrelationHeaders(input.interactionBinding, input.traceId),
 			executionProfile,
 			profilePlan,
 			attachments: preparedInput.attachments,
@@ -4556,6 +4569,6 @@ async function forgetSessionScopes(target) {
 	}
 }
 //#endregion
-export { ACP_MIN_PROTOCOL_VERSION, ACP_PROTOCOL_VERSION, AcpProviderAdapterBase, CODEX_DISABLED_FEATURE_ARGS, CliProviderAdapterBase, DEFAULT_INTERACTION_MCP_SERVER_NAME, EXECUTION_TRACE_HEADER, InteractionBroker, InteractionHttpBridge, InteractionMcpServer, InvalidAttachmentError, MANAGED_QUOTE_VERSION_HEADER, MAX_INLINE_IMAGE_BYTES, MAX_TOTAL_INLINE_IMAGE_BYTES, McpInteractionSupport, NATIVE_SESSION_CONTRACTS, PERMISSION_DECISION_TIMEOUT_MS, PROMPT_SECTION_SEPARATOR, SEALED_NATIVE_HOME_LAYOUT, SECRET_REFERENCE, SECRET_REFERENCE_PREFIX, SessionRehydrationError, TerminalPlanSupport, accumulateCliTokenUsage, acpContentText, assertSealedNativeHome, assertSealedNativeSearchPath, brokerInteractionTools, buildFileUrl, codexDeveloperInstructionArgs, createExecutionState, createRepeatedToolFailureGuard, deriveFilePart, deterministicFilePartId, enabledInteractionKinds, executionCorrelationHeaders, finalTextEvent, forgetSessionScopes, homeXdgEnv, inferMediaType, interactionMcpToolName, interactionToggleEnabled, isLocalMcpConfig, isLoopbackEndpoint, isPlainRecord, isTrustedStoreBinary, joinQueue, jsonEventParser, kimiThinkingArgs, localMcpArgv, localMcpEnv, nativeEffortArgs, parseCliUsageLine, partitionImageAttachments, plaintextResponseParser, preparePromptInputParts, prependPromptSection, provenStoreBinary, readCliTokenUsage, readEphemeralContext, reasoningEvents, recordCliTokenUsage, refuseSecretLaunch, rejectNotLaunched, requireRecord, resolveExecutableRealpath, resolveReferences, runtimeSecretsOverlay, secretMcpScope, secretSessionTurnQueue, servableMcpServer, servableStdioServer, sessionObservedEvents, spawnAcpBridge, streamPartBase, textDeltaEvents, textSnapshotEvents, toolResultEvents, toolStartEvents, trackFilePart, trackReasoningBlock, turnEndReason, turnInteractionEnabled, untilSettledOrAborted, wasNeverLaunched, withEphemeralContext, withTurnInteractions };
+export { ACP_MIN_PROTOCOL_VERSION, ACP_PROTOCOL_VERSION, AcpProviderAdapterBase, CODEX_DISABLED_FEATURE_ARGS, CliProviderAdapterBase, DEFAULT_INTERACTION_MCP_SERVER_NAME, EXECUTION_CORRELATION_HEADERS, EXECUTION_ID_HEADER, EXECUTION_TRACE_HEADER, InteractionBroker, InteractionHttpBridge, InteractionMcpServer, InvalidAttachmentError, MANAGED_QUOTE_VERSION_HEADER, MAX_INLINE_IMAGE_BYTES, MAX_TOTAL_INLINE_IMAGE_BYTES, McpInteractionSupport, NATIVE_SESSION_CONTRACTS, PERMISSION_DECISION_TIMEOUT_MS, PROMPT_SECTION_SEPARATOR, SEALED_NATIVE_HOME_LAYOUT, SECRET_REFERENCE, SECRET_REFERENCE_PREFIX, SessionRehydrationError, TerminalPlanSupport, accumulateCliTokenUsage, acpContentText, assertSealedNativeHome, assertSealedNativeSearchPath, brokerInteractionTools, buildFileUrl, codexDeveloperInstructionArgs, createExecutionState, createRepeatedToolFailureGuard, deriveFilePart, deterministicFilePartId, enabledInteractionKinds, executionCorrelationHeaders, finalTextEvent, forgetSessionScopes, homeXdgEnv, inferMediaType, interactionMcpToolName, interactionToggleEnabled, isLocalMcpConfig, isLoopbackEndpoint, isPlainRecord, isTrustedStoreBinary, joinQueue, jsonEventParser, kimiThinkingArgs, localMcpArgv, localMcpEnv, nativeEffortArgs, parseCliUsageLine, partitionImageAttachments, plaintextResponseParser, preparePromptInputParts, prependPromptSection, provenStoreBinary, readCliTokenUsage, readEphemeralContext, reasoningEvents, recordCliTokenUsage, refuseSecretLaunch, rejectNotLaunched, requireRecord, resolveExecutableRealpath, resolveReferences, runtimeSecretsOverlay, secretMcpScope, secretSessionTurnQueue, servableMcpServer, servableStdioServer, sessionObservedEvents, spawnAcpBridge, streamPartBase, textDeltaEvents, textSnapshotEvents, toolResultEvents, toolStartEvents, trackFilePart, trackReasoningBlock, turnEndReason, turnInteractionEnabled, untilSettledOrAborted, wasNeverLaunched, withEphemeralContext, withTurnInteractions };
 
 //# sourceMappingURL=index.mjs.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tangle-network/sdk-provider-cli-base",
-  "version": "0.13.1",
+  "version": "0.13.3",
   "description": "Base adapter for CLI-based AI agent providers",
   "type": "module",
   "main": "./dist/index.mjs",
@@ -24,8 +24,9 @@
     "@modelcontextprotocol/sdk": "^1.32.1",
     "@tangle-network/agent-core": "^1.0.0",
     "@tangle-network/agent-interface": "^5.10.13",
-    "@tangle-network/agent-profile-materialize": "1.1.25",
-    "@tangle-network/cli-agent-registry": "0.15.1",
+    "@tangle-network/agent-profile-materialize": "1.1.26",
+    "@tangle-network/agent-trace-contract": "^2.2.0",
+    "@tangle-network/cli-agent-registry": "0.15.2",
     "@tangle-network/sdk-cli-runner": "0.3.6",
     "@tangle-network/sdk-session-persistence": "0.7.2",
     "zod": "4.6.6"
@@ -42,8 +43,8 @@
     "registry": "https://registry.npmjs.org"
   },
   "tangleRelease": {
-    "sourceSha": "40d962aa0db50ba5bf53f55ac724694e1b13acde",
-    "mergedAt": "2026-11-02T10:03:01-08:00"
+    "sourceSha": "410434944bcd4ddf514b3374f92cc9d2cfc8997a",
+    "mergedAt": "2026-11-03T10:05:22-08:00"
   },
   "scripts": {
     "build": "tsdown",