@cursor/july 0.1.101 → 0.1.102

package/dist/internal/framework-file-storage.js

@@ -36,10 +36,10 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
         step((generator = generator.apply(thisArg, _arguments || [])).next());
     });
 };
-import { STORAGE_KEY_ROOT } from "../storage-protocol.js";
+import { AGENTSDK_STORAGE_KEY_ROOT } from "../storage-protocol.js";
 import { mapBounded } from "./bounded.js";
 /**
- * Key kinds (`agentkit/v1/{agent}/{kind}/…`) that live on the framework
+ * Key kinds (`agentsdk/v1/{agent}/{kind}/…`) that live on the framework
  * file store. Everything else stays on the KV sink.
  */
 const FRAMEWORK_FILE_KINDS = new Set([
@@ -55,10 +55,10 @@ const FRAMEWORK_FILE_KINDS = new Set([
  * kind-scoped (`…/{agent}/session/`), so a prefix routes wholly to one side.
  */
 export function isFrameworkFileKey(key) {
-    if (!key.startsWith(`${STORAGE_KEY_ROOT}/`)) {
+    if (!key.startsWith(`${AGENTSDK_STORAGE_KEY_ROOT}/`)) {
         return false;
     }
-    const rest = key.slice(STORAGE_KEY_ROOT.length + 1);
+    const rest = key.slice(AGENTSDK_STORAGE_KEY_ROOT.length + 1);
     const agentEnd = rest.indexOf("/");
     if (agentEnd === -1) {
         return false;
@@ -148,10 +148,10 @@ export function fileSinkStorageCore(sink) {
     };
 }
 function frameworkFileKind(key) {
-    if (!key.startsWith(`${STORAGE_KEY_ROOT}/`)) {
+    if (!key.startsWith(`${AGENTSDK_STORAGE_KEY_ROOT}/`)) {
         return undefined;
     }
-    const rest = key.slice(STORAGE_KEY_ROOT.length + 1);
+    const rest = key.slice(AGENTSDK_STORAGE_KEY_ROOT.length + 1);
     const agentEnd = rest.indexOf("/");
     if (agentEnd === -1) {
         return undefined;

package/dist/internal/framework-storage-selection.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"framework-storage-selection.d.ts","sourceRoot":"","sources":["../../src/internal/framework-storage-selection.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0CG;AAMH,OAAO,EAAiB,KAAK,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAEtE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AASrD,MAAM,WAAW,8BAA8B;IAC7C,2FAA2F;IAC3F,QAAQ,CAAC,QAAQ,EAAE,iBAAiB,GAAG,SAAS,CAAC;IACjD,0DAA0D;IAC1D,QAAQ,CAAC,YAAY,CAAC,EAAE,iBAAiB,GAAG,SAAS,CAAC;IACtD,iEAAiE;IACjE,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC;CACnD;AAED;;;;;GAKG;AACH,wBAAgB,gCAAgC,CAC9C,KAAK,EAAE,8BAA8B,GACpC,iBAAiB,GAAG,SAAS,CAqD/B"}
+{"version":3,"file":"framework-storage-selection.d.ts","sourceRoot":"","sources":["../../src/internal/framework-storage-selection.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0CG;AAGH,OAAO,EAAiB,KAAK,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAEtE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AASrD,MAAM,WAAW,8BAA8B;IAC7C,2FAA2F;IAC3F,QAAQ,CAAC,QAAQ,EAAE,iBAAiB,GAAG,SAAS,CAAC;IACjD,0DAA0D;IAC1D,QAAQ,CAAC,YAAY,CAAC,EAAE,iBAAiB,GAAG,SAAS,CAAC;IACtD,iEAAiE;IACjE,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC;CACnD;AAED;;;;;GAKG;AACH,wBAAgB,gCAAgC,CAC9C,KAAK,EAAE,8BAA8B,GACpC,iBAAiB,GAAG,SAAS,CAwD/B"}

package/dist/internal/framework-storage-selection.js

@@ -41,12 +41,12 @@
  * the session store; what this selects is the durable mirror *beyond* the
  * pod's filesystem.
  */
-import { cursorFrameworkStoreSourceId, cursorHostedFiles, } from "../files-backends/cursor-hosted.js";
+import { cursorHostedFiles } from "../files-backends/cursor-hosted.js";
 import { defineStorage } from "../storage.js";
 import { cursorHostedStorageV2 } from "../storage-backends/cursor-hosted-v2.js";
 import { resolveApiKeySync } from "./cursor/credentials.js";
-import { AGENT_SERVE_GENERATION_ENV_VAR } from "./cursor-relay-core.js";
 import { composeFrameworkStorage, fileSinkStorageCore, frameworkGuardedCas, } from "./framework-file-storage.js";
+import { resolveAgentV2Hosting } from "./v2-hosting.js";
 /**
  * Pick the backend for framework session state.
  *
@@ -54,7 +54,6 @@ import { composeFrameworkStorage, fileSinkStorageCore, frameworkGuardedCas, } fr
  * disk is the only copy.
  */
 export function selectFrameworkStorageDefinition(input) {
-    var _a;
     if (input.architecture !== "v2") {
         // v1: the author decides, or there is no mirror.
         return input.authored;
@@ -65,8 +64,11 @@ export function selectFrameworkStorageDefinition(input) {
         // rather than silently discard what the author believes is configured.
         throw new Error('defineStorage (agent/storage.ts) is not supported on architecture "v2": storage is platform-selected. Delete the file.');
     }
-    const env = (_a = input.env) !== null && _a !== void 0 ? _a : process.env;
-    if (env[AGENT_SERVE_GENERATION_ENV_VAR] === undefined) {
+    const hosting = resolveAgentV2Hosting({
+        architecture: input.architecture,
+        env: input.env,
+    });
+    if (hosting.kind !== "cursor-managed") {
         // Self-hosted v2: the state root is the durable copy.
         return undefined;
     }
@@ -76,7 +78,6 @@ export function selectFrameworkStorageDefinition(input) {
     // comes up). Follow-ups restore lazily by continuation or session id;
     // GET /v1/sessions lists from the sink either way.
     const policy = { restore: "off" };
-    const envSnapshot = env;
     // Full chain (env → bind file → stored login): frozen engines listen
     // unsigned and bind store ids + CURSOR_API_KEY at task time, after this
     // definition is constructed.
@@ -91,7 +92,7 @@ export function selectFrameworkStorageDefinition(input) {
     return defineStorage(Object.assign(Object.assign(Object.assign({ name: "cursor-hosted (framework files)", policy }, kv), composeFrameworkStorage({
         kv,
         files: fileSinkStorageCore(cursorHostedFiles({
-            resolveStoreSourceId: () => cursorFrameworkStoreSourceId(envSnapshot),
+            resolveStoreSourceId: () => hosting.resolveStoreIds().frameworkStoreSourceId,
             resolveApiKey,
         })),
     })), { 

package/dist/internal/frontmatter.d.ts

@@ -1,12 +1,20 @@
 /**
- * Minimal frontmatter parser. Supports the flat `key: value` scalar subset
- * used by authored markdown (skill descriptions, schedule cron expressions)
- * without pulling in a YAML dependency.
+ * Frontmatter parsers. Authored markdown (skill descriptions, schedule cron
+ * expressions) uses the flat `key: value` scalar subset; Cursor plugin
+ * markdown is full YAML (folded descriptions, lists).
  */
 export interface ParsedFrontmatter {
     data: Record<string, string>;
     body: string;
 }
+export interface ParsedYamlFrontmatter {
+    data: Record<string, unknown>;
+    body: string;
+    /** Why the block did not parse as a YAML mapping; `data` is then empty. */
+    error?: string;
+}
+/** YAML frontmatter with the JSON schema (no custom tags). */
+export declare function parseYamlFrontmatter(source: string): ParsedYamlFrontmatter;
 export declare function parseFrontmatter(source: string): ParsedFrontmatter;
 export declare function serializeFrontmatter(data: Record<string, string>): string;
 //# sourceMappingURL=frontmatter.d.ts.map

package/dist/internal/frontmatter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"frontmatter.d.ts","sourceRoot":"","sources":["../../src/internal/frontmatter.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7B,IAAI,EAAE,MAAM,CAAC;CACd;AAID,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,iBAAiB,CAsClE;AAED,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM,CAKzE"}
+{"version":3,"file":"frontmatter.d.ts","sourceRoot":"","sources":["../../src/internal/frontmatter.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7B,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,2EAA2E;IAC3E,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAKD,8DAA8D;AAC9D,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,MAAM,GAAG,qBAAqB,CAoB1E;AAED,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,iBAAiB,CAsClE;AAED,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM,CAKzE"}

package/dist/internal/frontmatter.js

@@ -1,9 +1,35 @@
 /**
- * Minimal frontmatter parser. Supports the flat `key: value` scalar subset
- * used by authored markdown (skill descriptions, schedule cron expressions)
- * without pulling in a YAML dependency.
+ * Frontmatter parsers. Authored markdown (skill descriptions, schedule cron
+ * expressions) uses the flat `key: value` scalar subset; Cursor plugin
+ * markdown is full YAML (folded descriptions, lists).
  */
+import { JSON_SCHEMA, load as parseYaml } from "js-yaml";
 const FRONTMATTER_OPEN = /^---\s*$/;
+const YAML_FRONTMATTER = /^---\r?\n([\s\S]*?)\r?\n---(?:\r?\n|$)([\s\S]*)$/;
+/** YAML frontmatter with the JSON schema (no custom tags). */
+export function parseYamlFrontmatter(source) {
+    var _a, _b;
+    const match = YAML_FRONTMATTER.exec(source);
+    if (match === null) {
+        return { data: {}, body: source };
+    }
+    const body = (_a = match[2]) !== null && _a !== void 0 ? _a : "";
+    let data;
+    try {
+        data = parseYaml((_b = match[1]) !== null && _b !== void 0 ? _b : "", { schema: JSON_SCHEMA });
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        return { data: {}, body, error: message };
+    }
+    if (data === undefined || data === null) {
+        return { data: {}, body };
+    }
+    if (typeof data !== "object" || Array.isArray(data)) {
+        return { data: {}, body, error: "frontmatter is not a mapping" };
+    }
+    return { data: data, body };
+}
 export function parseFrontmatter(source) {
     var _a, _b;
     const lines = source.split(/\r?\n/);

package/dist/internal/mcp-host.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mcp-host.d.ts","sourceRoot":"","sources":["../../src/internal/mcp-host.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAOH,OAAO,EAEL,KAAK,oBAAoB,EACzB,KAAK,iBAAiB,EACtB,KAAK,eAAe,EACpB,KAAK,eAAe,EAEpB,KAAK,kBAAkB,EACxB,MAAM,aAAa,CAAC;AAIrB,qBAAa,iBAAkB,SAAQ,KAAK;IAC1C,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAE5B,YAAY,UAAU,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,OAAO,EAS9C;CACF;AAED,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,OAAO,GACb,KAAK,IAAI,iBAAiB,CAE5B;AAED,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,iBAAiB,GAAG,OAAO,CAQvE;AAiBD;;;GAGG;AACH,MAAM,WAAW,aAAa;IAC5B,SAAS,IAAI,OAAO,CAAC,eAAe,EAAE,CAAC,CAAC;IACxC,QAAQ,CACN,QAAQ,EAAE,MAAM,EAChB,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC7B,OAAO,CAAC,iBAAiB,CAAC,CAAC;CAC/B;AAED,qBAAa,OAAQ,YAAW,eAAe;IAC7C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA2C;IAClE,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAgD;IACxE,OAAO,CAAC,gBAAgB,CAAqB;IAE7C,YAAY,WAAW,EAAE,oBAAoB,EAAE,EAI9C;IAED,gFAAgF;IAChF,mBAAmB,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAErC;IAED;;;OAGG;IACH,aAAa,CAAC,UAAU,EAAE,oBAAoB,GAAG,IAAI,CAEpD;IAED,KAAK,IAAI,MAAM,EAAE,CAEhB;IAEK,SAAS,CAAC,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC,CAQlE;IAED;;;;;;;;OAQG;IACH,MAAM,CAAC,UAAU,EAAE,oBAAoB,GAAG,aAAa,CAkCtD;IAEK,QAAQ,CACZ,cAAc,EAAE,MAAM,EACtB,QAAQ,EAAE,MAAM,EAChB,IAAI,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,GACjC,OAAO,CAAC,iBAAiB,CAAC,CAU5B;IAEK,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAW5C;IAEK,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAU3B;IAED;;;;;;;;OAQG;YACW,UAAU;IAiBxB,OAAO,CAAC,SAAS;YAYH,gBAAgB;IAiB9B,OAAO,CAAC,iBAAiB;YAWX,OAAO;CAGtB;AAcD,+BAA+B;AAC/B,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAU9D;AAKD;;;;;;;;;;;GAWG;AACH,wBAAgB,sBAAsB,CACpC,WAAW,EAAE,OAAO,GACnB,kBAAkB,GAAG,SAAS,CAyBhC"}
+{"version":3,"file":"mcp-host.d.ts","sourceRoot":"","sources":["../../src/internal/mcp-host.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAOH,OAAO,EAEL,KAAK,oBAAoB,EACzB,KAAK,iBAAiB,EACtB,KAAK,eAAe,EACpB,KAAK,eAAe,EAEpB,KAAK,kBAAkB,EACxB,MAAM,aAAa,CAAC;AASrB,qBAAa,iBAAkB,SAAQ,KAAK;IAC1C,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAE5B,YAAY,UAAU,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,OAAO,EAS9C;CACF;AAED,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,OAAO,GACb,KAAK,IAAI,iBAAiB,CAE5B;AAED,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,iBAAiB,GAAG,OAAO,CAQvE;AAiBD;;;GAGG;AACH,MAAM,WAAW,aAAa;IAC5B,SAAS,IAAI,OAAO,CAAC,eAAe,EAAE,CAAC,CAAC;IACxC,QAAQ,CACN,QAAQ,EAAE,MAAM,EAChB,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC7B,OAAO,CAAC,iBAAiB,CAAC,CAAC;CAC/B;AAED,qBAAa,OAAQ,YAAW,eAAe;IAC7C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA2C;IAClE,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAgD;IACxE,OAAO,CAAC,gBAAgB,CAAqB;IAE7C,YAAY,WAAW,EAAE,oBAAoB,EAAE,EAI9C;IAED,gFAAgF;IAChF,mBAAmB,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAErC;IAED;;;OAGG;IACH,aAAa,CAAC,UAAU,EAAE,oBAAoB,GAAG,IAAI,CAEpD;IAED,KAAK,IAAI,MAAM,EAAE,CAEhB;IAEK,SAAS,CAAC,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC,CAYlE;IAED;;;;;;;;OAQG;IACH,MAAM,CAAC,UAAU,EAAE,oBAAoB,GAAG,aAAa,CA+CtD;IAEK,QAAQ,CACZ,cAAc,EAAE,MAAM,EACtB,QAAQ,EAAE,MAAM,EAChB,IAAI,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,GACjC,OAAO,CAAC,iBAAiB,CAAC,CAkB5B;IAEK,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAW5C;IAEK,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAU3B;IAED;;;;;;;;OAQG;YACW,UAAU;IAiBxB,OAAO,CAAC,SAAS;YAYH,gBAAgB;IAiB9B,OAAO,CAAC,iBAAiB;YAWX,OAAO;CAGtB;AAcD,+BAA+B;AAC/B,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAU9D;AAKD;;;;;;;;;;;GAWG;AACH,wBAAgB,sBAAsB,CACpC,WAAW,EAAE,OAAO,GACnB,kBAAkB,GAAG,SAAS,CAyBhC"}

package/dist/internal/mcp-host.js

@@ -26,6 +26,7 @@ import { StreamableHTTPClientTransport } from "@modelcontextprotocol/sdk/client/
 import { connectionAllowsTool, } from "../types.js";
 import { CLI_COMMAND_NAME as CLI } from "./distribution.js";
 import { createHostMcpOAuthProvider } from "./mcp-oauth.js";
+import { instrumentedMcpFetch, mcpTraceMeta, runMcpClientSpan, } from "./otel/mcp.js";
 export class McpNeedsAuthError extends Error {
     constructor(connection, cause) {
         super(`MCP connection "${connection}" needs authorization. Run \`${CLI} mcp oauth ${connection}\`.`);
@@ -79,12 +80,12 @@ export class McpHost {
     listTools(connectionName) {
         return __awaiter(this, void 0, void 0, function* () {
             const connection = this.requireConnection(connectionName);
-            return this.withClient(connectionName, (client) => __awaiter(this, void 0, void 0, function* () {
-                const listed = yield client.listTools();
+            return runMcpClientSpan({ method: "tools/list", connection: connectionName }, () => this.withClient(connectionName, (client) => __awaiter(this, void 0, void 0, function* () {
+                const listed = yield client.listTools(mcpListParams());
                 return listed.tools
                     .map(toToolInfo)
                     .filter((tool) => connectionAllowsTool(connection, tool.name));
-            }));
+            })));
         });
     }
     /**
@@ -108,21 +109,22 @@ export class McpHost {
             }
         });
         return {
-            listTools: () => withFreshClient((client) => __awaiter(this, void 0, void 0, function* () {
-                const listed = yield client.listTools();
+            listTools: () => runMcpClientSpan({ method: "tools/list", connection: connection.name }, () => withFreshClient((client) => __awaiter(this, void 0, void 0, function* () {
+                const listed = yield client.listTools(mcpListParams());
                 return listed.tools
                     .map(toToolInfo)
                     .filter((tool) => connectionAllowsTool(connection, tool.name));
-            })),
+            }))),
             callTool: (toolName, args = {}) => {
                 assertConnectionAllowsTool(connection, toolName);
-                return withFreshClient((client) => __awaiter(this, void 0, void 0, function* () {
-                    const result = yield client.callTool({
-                        name: toolName,
-                        arguments: args,
-                    });
+                return runMcpClientSpan({
+                    method: "tools/call",
+                    connection: connection.name,
+                    toolName,
+                }, () => withFreshClient((client) => __awaiter(this, void 0, void 0, function* () {
+                    const result = yield client.callTool(Object.assign({ name: toolName, arguments: args }, mcpCallMeta()));
                     return throwIfCallNeedsAuth(connection.name, normalizeCallResult(result));
-                }));
+                })));
             },
         };
     }
@@ -130,13 +132,10 @@ export class McpHost {
         return __awaiter(this, arguments, void 0, function* (connectionName, toolName, args = {}) {
             const connection = this.requireConnection(connectionName);
             assertConnectionAllowsTool(connection, toolName);
-            return this.withClient(connectionName, (client) => __awaiter(this, void 0, void 0, function* () {
-                const result = yield client.callTool({
-                    name: toolName,
-                    arguments: args,
-                });
+            return runMcpClientSpan({ method: "tools/call", connection: connectionName, toolName }, () => this.withClient(connectionName, (client) => __awaiter(this, void 0, void 0, function* () {
+                const result = yield client.callTool(Object.assign({ name: toolName, arguments: args }, mcpCallMeta()));
                 return throwIfCallNeedsAuth(connectionName, normalizeCallResult(result));
-            }));
+            })));
         });
     }
     dropClient(name) {
@@ -363,12 +362,30 @@ function createTransport(connection, oauthRedirectUrl) {
                 redirectUrl: oauthRedirectUrl,
             })
             : undefined;
+        const fetchImpl = instrumentedMcpFetch();
+        const fetchLike = (url, init) => fetchImpl(url, init);
         if (transport.type === "sse") {
-            return new SSEClientTransport(url, { requestInit, authProvider });
+            return new SSEClientTransport(url, {
+                requestInit,
+                authProvider,
+                fetch: fetchLike,
+            });
         }
-        return new StreamableHTTPClientTransport(url, { requestInit, authProvider });
+        return new StreamableHTTPClientTransport(url, {
+            requestInit,
+            authProvider,
+            fetch: fetchLike,
+        });
     });
 }
+function mcpListParams() {
+    const meta = mcpTraceMeta();
+    return meta === undefined ? undefined : { _meta: meta };
+}
+function mcpCallMeta() {
+    const meta = mcpTraceMeta();
+    return meta === undefined ? {} : { _meta: meta };
+}
 function isOauthHttpTransport(transport) {
     return "url" in transport && transport.oauth === true;
 }

package/dist/internal/otel/collector.d.ts

@@ -9,9 +9,22 @@
 import type { SessionEvent, SessionInfo } from "../../types.js";
 import { type AttrValue } from "./attrs.js";
 import type { OtelRuntime } from "./runtime.js";
+export interface OtelCallContext {
+    sessionId: string;
+    session: SessionInfo;
+    turnId: string;
+    callId: string;
+    toolName: string;
+}
 export interface OtelCollector {
     onEvent(event: SessionEvent, session: SessionInfo): void;
     close(): void;
+    /**
+     * Run `fn` under the tool span so outbound inject sees that context.
+     * Opens the session / turn / tool span if the event stream has not
+     * reached `actions.requested` yet (dispatch is async).
+     */
+    runInCall<T>(args: OtelCallContext, fn: () => T | Promise<T>): Promise<T>;
     /** Merge author tags onto the session; paints open spans immediately. */
     setSessionAttributes(sessionId: string, attributes: Record<string, AttrValue>): void;
     /** Session tags previously set by {@link setSessionAttributes}. */

package/dist/internal/otel/collector.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"collector.d.ts","sourceRoot":"","sources":["../../../src/internal/otel/collector.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAaH,OAAO,KAAK,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAChE,OAAO,EAAE,KAAK,SAAS,EAAS,MAAM,YAAY,CAAC;AACnD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAIhD,MAAM,WAAW,aAAa;IAC5B,OAAO,CAAC,KAAK,EAAE,YAAY,EAAE,OAAO,EAAE,WAAW,GAAG,IAAI,CAAC;IACzD,KAAK,IAAI,IAAI,CAAC;IACd,yEAAyE;IACzE,oBAAoB,CAClB,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,GACpC,IAAI,CAAC;IACR,mEAAmE;IACnE,oBAAoB,CAClB,SAAS,EAAE,MAAM,GAChB,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,GAAG,SAAS,CAAC;CAC1C;AAgBD,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,WAAW,EACpB,SAAS,EAAE,MAAM,EACjB,GAAG,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,GAC1B,aAAa,CA8xBf"}
+{"version":3,"file":"collector.d.ts","sourceRoot":"","sources":["../../../src/internal/otel/collector.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAaH,OAAO,KAAK,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAChE,OAAO,EAAE,KAAK,SAAS,EAAS,MAAM,YAAY,CAAC;AACnD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAIhD,MAAM,WAAW,eAAe;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,WAAW,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,aAAa;IAC5B,OAAO,CAAC,KAAK,EAAE,YAAY,EAAE,OAAO,EAAE,WAAW,GAAG,IAAI,CAAC;IACzD,KAAK,IAAI,IAAI,CAAC;IACd;;;;OAIG;IACH,SAAS,CAAC,CAAC,EAAE,IAAI,EAAE,eAAe,EAAE,EAAE,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IAC1E,yEAAyE;IACzE,oBAAoB,CAClB,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,GACpC,IAAI,CAAC;IACR,mEAAmE;IACnE,oBAAoB,CAClB,SAAS,EAAE,MAAM,GAChB,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,GAAG,SAAS,CAAC;CAC1C;AAgBD,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,WAAW,EACpB,SAAS,EAAE,MAAM,EACjB,GAAG,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,GAC1B,aAAa,CAo3Bf"}

package/dist/internal/otel/collector.js

@@ -43,6 +43,10 @@ export function createOtelCollector(runtime, agentName, log) {
             const bag = extraBySession.get(sessionId);
             return bag === undefined ? undefined : Object.assign({}, bag);
         },
+        runInCall(args, fn) {
+            const span = ensureCallSpan(args);
+            return context.with(trace.setSpan(context.active(), span), () => Promise.resolve(fn()));
+        },
     };
     function handle(event, session) {
         var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l, _m, _o, _p, _q, _r, _s;
@@ -51,6 +55,9 @@ export function createOtelCollector(runtime, agentName, log) {
         const startTime = Number.isFinite(at) ? at : undefined;
         switch (event.type) {
             case "session.started": {
+                if (sessions.get(event.sessionId) !== undefined) {
+                    return;
+                }
                 openSession({
                     sessionId: event.sessionId,
                     session,
@@ -104,6 +111,15 @@ export function createOtelCollector(runtime, agentName, log) {
                 if (state === undefined) {
                     return;
                 }
+                // `runInCall` can open a synthetic turn before this event is
+                // applied. Keep that entry (and its in-flight tool spans) and
+                // just mark it real so `action.result` will not auto-close it.
+                const existing = state.turns.get(event.turnId);
+                if (existing !== undefined) {
+                    existing.synthetic = false;
+                    existing.span.setAttribute("agent_sdk.turn_synthetic", false);
+                    return;
+                }
                 openTurn({
                     state,
                     sessionId: event.sessionId,
@@ -144,24 +160,14 @@ export function createOtelCollector(runtime, agentName, log) {
                     return;
                 }
                 for (const call of event.data.calls) {
-                    const parentCtx = parentCtxFor(turn, (_t = event.data.parentCallId) !== null && _t !== void 0 ? _t : call.parentCallId);
-                    const span = runtime.tracer.startSpan("agent_sdk.tool", {
-                        kind: SpanKind.INTERNAL,
+                    openToolSpan({
+                        turn,
+                        sessionId: event.sessionId,
+                        turnId: event.turnId,
+                        call,
+                        parentCallId: (_t = event.data.parentCallId) !== null && _t !== void 0 ? _t : call.parentCallId,
                         startTime,
-                        attributes: join(event.sessionId, {
-                            "cursor.conversation.id": event.sessionId,
-                            "cursor.tool.name": call.toolName,
-                            "cursor.tool.kind": "builtin",
-                            "agent_sdk.agent": agentName,
-                            "agent_sdk.turn_id": event.turnId,
-                            "agent_sdk.call_id": call.callId,
-                            "agent_sdk.parent_call_id": call.parentCallId,
-                            "agent_sdk.tool_args": (logOpts === null || logOpts === void 0 ? void 0 : logOpts.toolContent) === true && call.args !== undefined
-                                ? truncate(json(call.args))
-                                : undefined,
-                        }),
-                    }, parentCtx);
-                    turn.tools.set(call.callId, span);
+                    });
                 }
                 return;
             }
@@ -466,6 +472,67 @@ export function createOtelCollector(runtime, agentName, log) {
         }
         return trace.setSpan(context.active(), turn.span);
     }
+    function openToolSpan(args) {
+        var _a, _b;
+        const existing = args.turn.tools.get(args.call.callId);
+        if (existing !== undefined) {
+            // Early `runInCall` opens with callId/toolName only. Fill in
+            // parent linkage and opt-in args when `actions.requested` arrives.
+            // The OTel parent is fixed at start; `parent_call_id` still records
+            // the event-stream hierarchy for nested/subagent calls.
+            existing.setAttributes(join(args.sessionId, {
+                "agent_sdk.parent_call_id": (_a = args.parentCallId) !== null && _a !== void 0 ? _a : args.call.parentCallId,
+                "agent_sdk.tool_args": (logOpts === null || logOpts === void 0 ? void 0 : logOpts.toolContent) === true && args.call.args !== undefined
+                    ? truncate(json(args.call.args))
+                    : undefined,
+            }));
+            return existing;
+        }
+        const span = runtime.tracer.startSpan("agent_sdk.tool", {
+            kind: SpanKind.INTERNAL,
+            startTime: args.startTime,
+            attributes: join(args.sessionId, {
+                "cursor.conversation.id": args.sessionId,
+                "cursor.tool.name": args.call.toolName,
+                "cursor.tool.kind": "builtin",
+                "agent_sdk.agent": agentName,
+                "agent_sdk.turn_id": args.turnId,
+                "agent_sdk.call_id": args.call.callId,
+                "agent_sdk.parent_call_id": args.call.parentCallId,
+                "agent_sdk.tool_args": (logOpts === null || logOpts === void 0 ? void 0 : logOpts.toolContent) === true && args.call.args !== undefined
+                    ? truncate(json(args.call.args))
+                    : undefined,
+            }),
+        }, parentCtxFor(args.turn, (_b = args.parentCallId) !== null && _b !== void 0 ? _b : args.call.parentCallId));
+        args.turn.tools.set(args.call.callId, span);
+        return span;
+    }
+    function ensureCallSpan(args) {
+        var _a, _b;
+        const startTime = Date.now();
+        const state = (_a = sessions.get(args.sessionId)) !== null && _a !== void 0 ? _a : openSession({
+            sessionId: args.sessionId,
+            session: args.session,
+            channelId: args.session.channelId,
+            startTime,
+            restored: true,
+        });
+        const turn = (_b = state.turns.get(args.turnId)) !== null && _b !== void 0 ? _b : openTurn({
+            state,
+            sessionId: args.sessionId,
+            turnId: args.turnId,
+            session: args.session,
+            startTime,
+            synthetic: true,
+        });
+        return openToolSpan({
+            turn,
+            sessionId: args.sessionId,
+            turnId: args.turnId,
+            call: { callId: args.callId, toolName: args.toolName },
+            startTime,
+        });
+    }
     function endOpenChildren(turn, endTime) {
         for (const span of turn.tools.values()) {
             span.end(endTime);

package/dist/internal/otel/http.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"http.d.ts","sourceRoot":"","sources":["../../../src/internal/otel/http.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAUjE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAiBhD;;;GAGG;AACH,wBAAgB,cAAc,CAAC,CAAC,EAC9B,OAAO,EAAE,WAAW,GAAG,SAAS,EAChC,GAAG,EAAE,eAAe,EACpB,GAAG,EAAE,cAAc,EACnB,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GACnB,OAAO,CAAC,CAAC,CAAC,CAcZ"}
+{"version":3,"file":"http.d.ts","sourceRoot":"","sources":["../../../src/internal/otel/http.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAUjE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAOhD;;;GAGG;AACH,wBAAgB,cAAc,CAAC,CAAC,EAC9B,OAAO,EAAE,WAAW,GAAG,SAAS,EAChC,GAAG,EAAE,eAAe,EACpB,GAAG,EAAE,cAAc,EACnB,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GACnB,OAAO,CAAC,CAAC,CAAC,CAcZ"}

package/dist/internal/otel/http.js

@@ -2,15 +2,7 @@
  * HTTP SERVER spans + W3C `traceparent` extraction for inbound requests.
  */
 import { context, propagation, SpanKind, SpanStatusCode, trace, } from "@opentelemetry/api";
-import { W3CTraceContextPropagator } from "@opentelemetry/core";
-let propagatorInstalled = false;
-function ensurePropagator() {
-    if (propagatorInstalled) {
-        return;
-    }
-    propagation.setGlobalPropagator(new W3CTraceContextPropagator());
-    propagatorInstalled = true;
-}
+import { ensureW3cPropagator } from "./propagation.js";
 /**
  * Instrument one inbound Node request: SERVER span, W3C extract, auto-end
  * on response finish/close, run `fn` under the span context.
@@ -35,7 +27,7 @@ function startHttpSpan(runtime, req) {
     if (runtime === undefined || runtime.config.traces === false) {
         return undefined;
     }
-    ensurePropagator();
+    ensureW3cPropagator();
     const headers = {};
     for (const [key, value] of Object.entries(req.headers)) {
         if (typeof value === "string") {

package/dist/internal/otel/mcp.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Client-side MCP instrumentation: W3C / Cursor HTTP inject on Streamable
+ * HTTP + SSE fetches, SEP-414 `_meta.traceparent` on JSON-RPC params, and
+ * CLIENT spans for `tools/list` / `tools/call`.
+ */
+export declare function instrumentedMcpFetch(base?: typeof fetch): typeof fetch;
+/** SEP-414 / OTel MCP carrier for `params._meta`. */
+export declare function mcpTraceMeta(): {
+    traceparent: string;
+} | undefined;
+export declare function runMcpClientSpan<T>(args: {
+    method: string;
+    connection: string;
+    toolName?: string;
+}, fn: () => Promise<T>): Promise<T>;
+//# sourceMappingURL=mcp.d.ts.map

package/dist/internal/otel/mcp.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp.d.ts","sourceRoot":"","sources":["../../../src/internal/otel/mcp.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAQH,wBAAgB,oBAAoB,CAAC,IAAI,GAAE,OAAO,KAAa,GAAG,OAAO,KAAK,CAW7E;AAED,qDAAqD;AACrD,wBAAgB,YAAY,IAAI;IAAE,WAAW,EAAE,MAAM,CAAA;CAAE,GAAG,SAAS,CAUlE;AAED,wBAAgB,gBAAgB,CAAC,CAAC,EAChC,IAAI,EAAE;IACJ,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,EACD,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GACnB,OAAO,CAAC,CAAC,CAAC,CAuBZ"}

package/dist/internal/otel/mcp.js

@@ -0,0 +1,68 @@
+/**
+ * Client-side MCP instrumentation: W3C / Cursor HTTP inject on Streamable
+ * HTTP + SSE fetches, SEP-414 `_meta.traceparent` on JSON-RPC params, and
+ * CLIENT spans for `tools/list` / `tools/call`.
+ */
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+import { context, SpanKind, SpanStatusCode, trace } from "@opentelemetry/api";
+import { formatTraceparent, injectActiveTraceContext } from "../../otel.js";
+import { attrs } from "./attrs.js";
+const TRACER = "agent_sdk";
+export function instrumentedMcpFetch(base = fetch) {
+    return (input, init) => {
+        if (input instanceof Request && init === undefined) {
+            const headers = new Headers(input.headers);
+            injectActiveTraceContext(headers);
+            return base(new Request(input, { headers }));
+        }
+        const headers = new Headers(init === null || init === void 0 ? void 0 : init.headers);
+        injectActiveTraceContext(headers);
+        return base(input, Object.assign(Object.assign({}, init), { headers }));
+    };
+}
+/** SEP-414 / OTel MCP carrier for `params._meta`. */
+export function mcpTraceMeta() {
+    const span = trace.getSpan(context.active());
+    if (span === undefined) {
+        return undefined;
+    }
+    const traceparent = formatTraceparent(span.spanContext());
+    if (traceparent === undefined) {
+        return undefined;
+    }
+    return { traceparent };
+}
+export function runMcpClientSpan(args, fn) {
+    const span = trace.getTracer(TRACER).startSpan(args.method, {
+        kind: SpanKind.CLIENT,
+        attributes: attrs({
+            "rpc.system": "mcp",
+            "mcp.method.name": args.method,
+            "mcp.tool.name": args.toolName,
+            "agent_sdk.mcp.connection": args.connection,
+        }),
+    });
+    return context.with(trace.setSpan(context.active(), span), () => __awaiter(this, void 0, void 0, function* () {
+        try {
+            return yield fn();
+        }
+        catch (error) {
+            span.setStatus({
+                code: SpanStatusCode.ERROR,
+                message: error instanceof Error ? error.message : String(error),
+            });
+            throw error;
+        }
+        finally {
+            span.end();
+        }
+    }));
+}

package/dist/internal/otel/propagation.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Process-global W3C `traceparent` propagator. Inbound HTTP extracts;
+ * outbound Factory / Cursor API calls inject.
+ */
+export declare function ensureW3cPropagator(): void;
+//# sourceMappingURL=propagation.d.ts.map

package/dist/internal/otel/propagation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"propagation.d.ts","sourceRoot":"","sources":["../../../src/internal/otel/propagation.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAOH,wBAAgB,mBAAmB,IAAI,IAAI,CAM1C"}

package/dist/internal/otel/propagation.js

@@ -0,0 +1,14 @@
+/**
+ * Process-global W3C `traceparent` propagator. Inbound HTTP extracts;
+ * outbound Factory / Cursor API calls inject.
+ */
+import { propagation } from "@opentelemetry/api";
+import { W3CTraceContextPropagator } from "@opentelemetry/core";
+let installed = false;
+export function ensureW3cPropagator() {
+    if (installed) {
+        return;
+    }
+    propagation.setGlobalPropagator(new W3CTraceContextPropagator());
+    installed = true;
+}

package/dist/internal/otel/runtime.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../../../src/internal/otel/runtime.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAEnE,OAAO,KAAK,EAAE,MAAM,IAAI,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAgCpE,OAAO,EAAsB,KAAK,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAI1E,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,kBAAkB,CAAC;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,KAAK,GAAG,SAAS,CAAC;IACzB,MAAM,EAAE,UAAU,GAAG,SAAS,CAAC;IAC/B,YAAY,EAAE,SAAS,GAAG,SAAS,CAAC;IACpC,QAAQ,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC/B;AAED,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,kBAAkB,EAC1B,GAAG,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,GAC1B,WAAW,GAAG,SAAS,CA6BzB;AAED,wBAAsB,mBAAmB,CACvC,OAAO,EAAE,WAAW,GAAG,SAAS,GAC/B,OAAO,CAAC,IAAI,CAAC,CAEf"}
+{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../../../src/internal/otel/runtime.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAEnE,OAAO,KAAK,EAAE,MAAM,IAAI,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAgCpE,OAAO,EAAsB,KAAK,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAK1E,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,kBAAkB,CAAC;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,KAAK,GAAG,SAAS,CAAC;IACzB,MAAM,EAAE,UAAU,GAAG,SAAS,CAAC;IAC/B,YAAY,EAAE,SAAS,GAAG,SAAS,CAAC;IACpC,QAAQ,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC/B;AAED,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,kBAAkB,EAC1B,GAAG,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,GAC1B,WAAW,GAAG,SAAS,CA8BzB;AAED,wBAAsB,mBAAmB,CACvC,OAAO,EAAE,WAAW,GAAG,SAAS,GAC/B,OAAO,CAAC,IAAI,CAAC,CAEf"}

package/dist/internal/otel/runtime.js

@@ -28,6 +28,7 @@ import { AggregationTemporality, MeterProvider, PeriodicExportingMetricReader, }
 import { BatchSpanProcessor, NodeTracerProvider, ParentBasedSampler, TraceIdRatioBasedSampler, } from "@opentelemetry/sdk-trace-node";
 import { ATTR_SERVICE_NAME, ATTR_SERVICE_VERSION, } from "@opentelemetry/semantic-conventions";
 import { exportersForSignal } from "./config.js";
+import { ensureW3cPropagator } from "./propagation.js";
 const INSTRUMENTATION = "agent_sdk";
 export function createOtelRuntime(config, log) {
     var _a;
@@ -38,6 +39,7 @@ export function createOtelRuntime(config, log) {
     if (proto === "grpc") {
         log("[agent-sdk:otel] OTEL_EXPORTER_OTLP_PROTOCOL=grpc is unsupported; using http/protobuf");
     }
+    ensureW3cPropagator();
     const sdk = startOtelSdk(config, log);
     const meter = config.metrics === false
         ? undefined

package/dist/internal/session-engine.d.ts

@@ -523,6 +523,11 @@ export declare class SessionEngine {
     hasActiveTurn(sessionId: string): boolean;
     callActiveServerTool(sessionId: string, toolName: string, input: unknown): Promise<SDKCustomToolResult>;
     private executeServerTool;
+    /**
+     * Bind outbound inject (Factory / Cursor API `traceparent`) to the
+     * tool span. No-op when OTel is off.
+     */
+    private runToolExecute;
     /**
      * Park a server-tool call until a human approves or denies. Emits
      * `action.approval_requested` / `action.approval_resolved` on the