@vercel/agent-runs 0.0.0-stage → 0.0.1

package/dist/src/ai-sdk.d.ts

@@ -0,0 +1,8 @@
+/**
+ * AI SDK integration. `aiSdkTelemetry` records `generateText`, `streamText`,
+ * and AI SDK agents as turns; `modelUsage` and `modelContent` convert AI SDK
+ * payloads for hosts that record model calls themselves.
+ */
+export { aiSdkTelemetry, type AiSdkTelemetryOptions } from "./adapters/ai-sdk-telemetry.js";
+export { modelUsage, modelContent } from "./adapters/ai-sdk-payload.js";
+//# sourceMappingURL=ai-sdk.d.ts.map

package/dist/src/ai-sdk.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ai-sdk.d.ts","sourceRoot":"","sources":["../../src/ai-sdk.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,cAAc,EAAE,KAAK,qBAAqB,EAAE,MAAM,gCAAgC,CAAC;AAC5F,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC"}

package/dist/src/ai-sdk.js

@@ -0,0 +1,8 @@
+/**
+ * AI SDK integration. `aiSdkTelemetry` records `generateText`, `streamText`,
+ * and AI SDK agents as turns; `modelUsage` and `modelContent` convert AI SDK
+ * payloads for hosts that record model calls themselves.
+ */
+export { aiSdkTelemetry } from "./adapters/ai-sdk-telemetry.js";
+export { modelUsage, modelContent } from "./adapters/ai-sdk-payload.js";
+//# sourceMappingURL=ai-sdk.js.map

package/dist/src/ai-sdk.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ai-sdk.js","sourceRoot":"","sources":["../../src/ai-sdk.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,cAAc,EAA8B,MAAM,gCAAgC,CAAC;AAC5F,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC"}

package/dist/src/capture.d.ts

@@ -0,0 +1,6 @@
+import type { CaptureDecision } from "./core/types.js";
+export declare function currentCapture(): CaptureDecision | undefined;
+export declare function withCapture<T extends {
+    setValue(key: symbol, value: unknown): T;
+}>(host: T, capture: CaptureDecision): T;
+//# sourceMappingURL=capture.d.ts.map

package/dist/src/capture.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"capture.d.ts","sourceRoot":"","sources":["../../src/capture.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAGvD,wBAAgB,cAAc,IAAI,eAAe,GAAG,SAAS,CAE5D;AACD,wBAAgB,WAAW,CAAC,CAAC,SAAS;IAAE,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,CAAC,CAAA;CAAE,EAChF,IAAI,EAAE,CAAC,EACP,OAAO,EAAE,eAAe,GACvB,CAAC,CAEH"}

package/dist/src/capture.js

@@ -0,0 +1,9 @@
+import { context, createContextKey } from "@opentelemetry/api";
+const CAPTURE = createContextKey("agent.tracing.capture");
+export function currentCapture() {
+    return context.active().getValue(CAPTURE);
+}
+export function withCapture(host, capture) {
+    return host.setValue(CAPTURE, capture);
+}
+//# sourceMappingURL=capture.js.map

package/dist/src/capture.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"capture.js","sourceRoot":"","sources":["../../src/capture.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAG/D,MAAM,OAAO,GAAG,gBAAgB,CAAC,uBAAuB,CAAC,CAAC;AAC1D,MAAM,UAAU,cAAc;IAC5B,OAAO,OAAO,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,OAAO,CAAgC,CAAC;AAC3E,CAAC;AACD,MAAM,UAAU,WAAW,CACzB,IAAO,EACP,OAAwB;IAExB,OAAO,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;AACzC,CAAC"}

package/dist/src/core/activation.d.ts

@@ -0,0 +1,4 @@
+import type { ActiveOperation, CaptureDecision } from "./types.js";
+export declare function intersectCapture(capture: CaptureDecision, ceiling?: CaptureDecision): CaptureDecision;
+export declare function activeOperation(operation: ActiveOperation, capture: CaptureDecision): ActiveOperation;
+//# sourceMappingURL=activation.d.ts.map

package/dist/src/core/activation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"activation.d.ts","sourceRoot":"","sources":["../../../src/core/activation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAEnE,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,eAAe,EACxB,OAAO,CAAC,EAAE,eAAe,GACxB,eAAe,CAOjB;AAED,wBAAgB,eAAe,CAC7B,SAAS,EAAE,eAAe,EAC1B,OAAO,EAAE,eAAe,GACvB,eAAe,CAwBjB"}

package/dist/src/core/activation.js

@@ -0,0 +1,31 @@
+export function intersectCapture(capture, ceiling) {
+    const emit = capture.emit && (ceiling?.emit ?? true);
+    return {
+        emit,
+        recordInputs: emit && capture.recordInputs && (ceiling?.recordInputs ?? true),
+        recordOutputs: emit && capture.recordOutputs && (ceiling?.recordOutputs ?? true),
+    };
+}
+export function activeOperation(operation, capture) {
+    const mcp = operation.mcp;
+    return {
+        type: operation.type,
+        reference: operation.reference,
+        capture,
+        mcp: mcp === undefined
+            ? undefined
+            : {
+                update: (input) => mcp.update(input),
+                error: (error, type) => mcp.error(capture.recordOutputs ? error : undefined, type ?? (error instanceof Error ? error.name : undefined)),
+                arguments: (value) => {
+                    if (capture.recordInputs)
+                        mcp.arguments(value);
+                },
+                result: (value) => {
+                    if (capture.recordOutputs)
+                        mcp.result(value);
+                },
+            },
+    };
+}
+//# sourceMappingURL=activation.js.map

package/dist/src/core/activation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"activation.js","sourceRoot":"","sources":["../../../src/core/activation.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,gBAAgB,CAC9B,OAAwB,EACxB,OAAyB;IAEzB,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,IAAI,CAAC,OAAO,EAAE,IAAI,IAAI,IAAI,CAAC,CAAC;IACrD,OAAO;QACL,IAAI;QACJ,YAAY,EAAE,IAAI,IAAI,OAAO,CAAC,YAAY,IAAI,CAAC,OAAO,EAAE,YAAY,IAAI,IAAI,CAAC;QAC7E,aAAa,EAAE,IAAI,IAAI,OAAO,CAAC,aAAa,IAAI,CAAC,OAAO,EAAE,aAAa,IAAI,IAAI,CAAC;KACjF,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,eAAe,CAC7B,SAA0B,EAC1B,OAAwB;IAExB,MAAM,GAAG,GAAG,SAAS,CAAC,GAAG,CAAC;IAC1B,OAAO;QACL,IAAI,EAAE,SAAS,CAAC,IAAI;QACpB,SAAS,EAAE,SAAS,CAAC,SAAS;QAC9B,OAAO;QACP,GAAG,EACD,GAAG,KAAK,SAAS;YACf,CAAC,CAAC,SAAS;YACX,CAAC,CAAC;gBACE,MAAM,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC;gBACpC,KAAK,EAAE,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE,CACrB,GAAG,CAAC,KAAK,CACP,OAAO,CAAC,aAAa,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,EACzC,IAAI,IAAI,CAAC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,CAC1D;gBACH,SAAS,EAAE,CAAC,KAAK,EAAE,EAAE;oBACnB,IAAI,OAAO,CAAC,YAAY;wBAAE,GAAG,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;gBACjD,CAAC;gBACD,MAAM,EAAE,CAAC,KAAK,EAAE,EAAE;oBAChB,IAAI,OAAO,CAAC,aAAa;wBAAE,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;gBAC/C,CAAC;aACF;KACR,CAAC;AACJ,CAAC"}

package/dist/src/core/attributes.d.ts

@@ -0,0 +1,15 @@
+import type { Attributes, FrameworkIdentity, RunIdentity, Usage } from "./types.js";
+export declare const USAGE_FIELDS: {
+    readonly costUsd: "agent.usage.cost_usd";
+    readonly inputTokens: "agent.usage.input_tokens";
+    readonly outputTokens: "agent.usage.output_tokens";
+    readonly cacheReadTokens: "agent.usage.cache_read_tokens";
+    readonly cacheWriteTokens: "agent.usage.cache_write_tokens";
+};
+export declare function identityAttributes(identity: Pick<RunIdentity, "runId" | "conversationId">): Attributes;
+export declare function namingAttributes(name: string, operation?: string): Attributes;
+export declare function frameworkAttributes(framework?: FrameworkIdentity): Attributes;
+/** Invocation and model spans use GenAI token counts; structural spans use eve's. */
+export declare function usageAttributes(usage: Usage, genAi?: boolean): Attributes;
+export declare function runtimeContextAttributes(input: Readonly<Record<string, unknown>> | undefined): Attributes;
+//# sourceMappingURL=attributes.d.ts.map

package/dist/src/core/attributes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"attributes.d.ts","sourceRoot":"","sources":["../../../src/core/attributes.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAkB,UAAU,EAAE,iBAAiB,EAAE,WAAW,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAEpG,eAAO,MAAM,YAAY;aACvB,OAAO,EAAE,sBAAsB;aAC/B,WAAW,EAAE,0BAA0B;aACvC,YAAY,EAAE,2BAA2B;aACzC,eAAe,EAAE,+BAA+B;aAChD,gBAAgB,EAAE,gCAAgC;CAC1C,CAAC;AAEX,wBAAgB,kBAAkB,CAChC,QAAQ,EAAE,IAAI,CAAC,WAAW,EAAE,OAAO,GAAG,gBAAgB,CAAC,GACtD,UAAU,CAMZ;AAED,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,SAAO,GAAG,UAAU,CAE3E;AAED,wBAAgB,mBAAmB,CAAC,SAAS,CAAC,EAAE,iBAAiB,GAAG,UAAU,CAK7E;AAED,qFAAqF;AACrF,wBAAgB,eAAe,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,UAAQ,GAAG,UAAU,CAgBvE;AAED,wBAAgB,wBAAwB,CACtC,KAAK,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GAAG,SAAS,GACnD,UAAU,CAgCZ"}

package/dist/src/core/attributes.js

@@ -0,0 +1,76 @@
+const TRACE_SCHEMA_VERSION = 4;
+export const USAGE_FIELDS = {
+    costUsd: "agent.usage.cost_usd",
+    inputTokens: "agent.usage.input_tokens",
+    outputTokens: "agent.usage.output_tokens",
+    cacheReadTokens: "agent.usage.cache_read_tokens",
+    cacheWriteTokens: "agent.usage.cache_write_tokens",
+};
+export function identityAttributes(identity) {
+    return {
+        "agent.run.id": identity.runId,
+        "agent.trace.schema.version": TRACE_SCHEMA_VERSION,
+        "gen_ai.conversation.id": identity.conversationId,
+    };
+}
+export function namingAttributes(name, operation = name) {
+    return { "operation.name": operation, "resource.name": name };
+}
+export function frameworkAttributes(framework) {
+    return {
+        "agent.framework.name": framework?.name || undefined,
+        "agent.framework.version": framework?.version || undefined,
+    };
+}
+/** Invocation and model spans use GenAI token counts; structural spans use eve's. */
+export function usageAttributes(usage, genAi = false) {
+    if (genAi)
+        return {
+            [USAGE_FIELDS.costUsd]: usage.costUsd,
+            "gen_ai.usage.input_tokens": usage.inputTokens,
+            "gen_ai.usage.output_tokens": usage.outputTokens,
+            "gen_ai.usage.cache_read.input_tokens": usage.inputTokenDetails?.cacheReadTokens,
+            "gen_ai.usage.cache_write.input_tokens": usage.inputTokenDetails?.cacheWriteTokens,
+        };
+    return {
+        [USAGE_FIELDS.costUsd]: usage.costUsd,
+        [USAGE_FIELDS.inputTokens]: usage.inputTokens,
+        [USAGE_FIELDS.outputTokens]: usage.outputTokens,
+        [USAGE_FIELDS.cacheReadTokens]: usage.inputTokenDetails?.cacheReadTokens,
+        [USAGE_FIELDS.cacheWriteTokens]: usage.inputTokenDetails?.cacheWriteTokens,
+    };
+}
+export function runtimeContextAttributes(input) {
+    const attributes = {};
+    const seen = new WeakSet();
+    let remaining = 256;
+    function visit(key, value, depth) {
+        if (remaining <= 0 || depth > 8 || value == null)
+            return;
+        if (typeof value === "string" || typeof value === "number" || typeof value === "boolean") {
+            attributes[key] = value;
+            remaining -= 1;
+        }
+        else if (Array.isArray(value)) {
+            if (value.length <= 256 &&
+                value.every((item) => typeof item === "string" || typeof item === "number" || typeof item === "boolean") &&
+                new Set(value.map((item) => typeof item)).size === 1) {
+                attributes[key] = value;
+                remaining -= 1;
+            }
+        }
+        else if (typeof value === "object" && !seen.has(value)) {
+            seen.add(value);
+            for (const keyPart of Object.keys(value)) {
+                if (remaining <= 0)
+                    break;
+                visit(`${key}.${keyPart}`, Reflect.get(value, keyPart), depth + 1);
+            }
+            seen.delete(value);
+        }
+    }
+    if (input !== undefined)
+        visit("ai.settings.context", input, 0);
+    return attributes;
+}
+//# sourceMappingURL=attributes.js.map

package/dist/src/core/attributes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"attributes.js","sourceRoot":"","sources":["../../../src/core/attributes.ts"],"names":[],"mappings":"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"}

package/dist/src/core/content-policy.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Which span attributes carry conversation content, and in which direction.
+ *
+ * Two vocabularies land on the same spans: the ones the library sets on its own
+ * `agent.*` spans, and the ones the AI SDK's OpenTelemetry integration sets on
+ * the model-call spans beneath them. A destination that declined content has to
+ * be rid of both, so both are listed here rather than in the module that writes
+ * each.
+ *
+ * Listed by name rather than by prefix because the prefixes are shared with
+ * metadata that must survive: `ai.response.finish_reason` and
+ * `gen_ai.tool.name` say what happened, not what was said. The cost is that a
+ * new content attribute in a dependency is not covered until it is added here.
+ */
+/** What one destination is willing to receive. */
+export interface ResolvedContentOptions {
+    readonly recordInputs: boolean;
+    readonly recordOutputs: boolean;
+}
+/**
+ * The attributes with the declined content removed, or `undefined` when there
+ * was none to remove.
+ *
+ * The `undefined` return is what lets the caller forward the original span
+ * untouched in the common case, so a destination that declined a direction the
+ * span never carried costs one pass over its keys and no allocation.
+ */
+export declare function withoutDeclinedContent(attributes: Readonly<Record<string, unknown>>, content: ResolvedContentOptions): Record<string, unknown> | undefined;
+//# sourceMappingURL=content-policy.d.ts.map

package/dist/src/core/content-policy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"content-policy.d.ts","sourceRoot":"","sources":["../../../src/core/content-policy.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AA+CH,kDAAkD;AAClD,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAC;IAC/B,QAAQ,CAAC,aAAa,EAAE,OAAO,CAAC;CACjC;AA2BD;;;;;;;GAOG;AACH,wBAAgB,sBAAsB,CACpC,UAAU,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,EAC7C,OAAO,EAAE,sBAAsB,GAC9B,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAarC"}

package/dist/src/core/content-policy.js

@@ -0,0 +1,94 @@
+/**
+ * Which span attributes carry conversation content, and in which direction.
+ *
+ * Two vocabularies land on the same spans: the ones the library sets on its own
+ * `agent.*` spans, and the ones the AI SDK's OpenTelemetry integration sets on
+ * the model-call spans beneath them. A destination that declined content has to
+ * be rid of both, so both are listed here rather than in the module that writes
+ * each.
+ *
+ * Listed by name rather than by prefix because the prefixes are shared with
+ * metadata that must survive: `ai.response.finish_reason` and
+ * `gen_ai.tool.name` say what happened, not what was said. The cost is that a
+ * new content attribute in a dependency is not covered until it is added here.
+ */
+/** Prompts, instructions, tool arguments — what went in. */
+const INPUT_CONTENT_ATTRIBUTES = new Set([
+    "agent.channel.delivery.input",
+    "agent.session.title",
+    "agent.approval.request",
+    "ai.documents",
+    "ai.prompt",
+    "ai.prompt.toolChoice",
+    "ai.prompt.tools",
+    "ai.value",
+    "ai.values",
+    "gen_ai.input.messages",
+    "gen_ai.memory.records",
+    "gen_ai.system_instructions",
+    "gen_ai.tool.call.arguments",
+    "gen_ai.tool.definitions",
+]);
+/**
+ * Responses, reasoning, tool results — what came out.
+ *
+ * `ai.toolCall.args` is here rather than above because the AI SDK gates it on
+ * `recordOutputs`; matching that is what keeps one destination's view coherent.
+ */
+const OUTPUT_CONTENT_ATTRIBUTES = new Set([
+    "agent.approval.response",
+    "ai.embedding",
+    "ai.embeddings",
+    "ai.ranking",
+    "ai.response.files",
+    "ai.response.object",
+    "ai.response.reasoning",
+    "ai.response.text",
+    "ai.response.toolCalls",
+    "ai.response.tool_calls",
+    "ai.response.tool_results",
+    "ai.toolCall.args",
+    "ai.toolCall.result",
+    "gen_ai.output.messages",
+    "gen_ai.tool.call.result",
+]);
+const INPUT_POLICY_ATTRIBUTE = "agent.trace.content.input";
+const OUTPUT_POLICY_ATTRIBUTE = "agent.trace.content.output";
+function isDeclined(key, content) {
+    if (!content.recordInputs && INPUT_CONTENT_ATTRIBUTES.has(key))
+        return true;
+    return !content.recordOutputs && OUTPUT_CONTENT_ATTRIBUTES.has(key);
+}
+function narrowsContentPolicy(attributes, content) {
+    return ((!content.recordInputs && attributes[INPUT_POLICY_ATTRIBUTE] === true) ||
+        (!content.recordOutputs && attributes[OUTPUT_POLICY_ATTRIBUTE] === true));
+}
+function exportedAttributeValue(key, value, content) {
+    if (key === INPUT_POLICY_ATTRIBUTE && value === true && !content.recordInputs)
+        return false;
+    if (key === OUTPUT_POLICY_ATTRIBUTE && value === true && !content.recordOutputs)
+        return false;
+    return value;
+}
+/**
+ * The attributes with the declined content removed, or `undefined` when there
+ * was none to remove.
+ *
+ * The `undefined` return is what lets the caller forward the original span
+ * untouched in the common case, so a destination that declined a direction the
+ * span never carried costs one pass over its keys and no allocation.
+ */
+export function withoutDeclinedContent(attributes, content) {
+    const keys = Object.keys(attributes);
+    if (!keys.some((key) => isDeclined(key, content)) && !narrowsContentPolicy(attributes, content)) {
+        return undefined;
+    }
+    const kept = {};
+    for (const key of keys) {
+        if (!isDeclined(key, content)) {
+            kept[key] = exportedAttributeValue(key, attributes[key], content);
+        }
+    }
+    return kept;
+}
+//# sourceMappingURL=content-policy.js.map

package/dist/src/core/content-policy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"content-policy.js","sourceRoot":"","sources":["../../../src/core/content-policy.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,4DAA4D;AAC5D,MAAM,wBAAwB,GAAwB,IAAI,GAAG,CAAC;IAC5D,8BAA8B;IAC9B,qBAAqB;IACrB,wBAAwB;IACxB,cAAc;IACd,WAAW;IACX,sBAAsB;IACtB,iBAAiB;IACjB,UAAU;IACV,WAAW;IACX,uBAAuB;IACvB,uBAAuB;IACvB,4BAA4B;IAC5B,4BAA4B;IAC5B,yBAAyB;CAC1B,CAAC,CAAC;AAEH;;;;;GAKG;AACH,MAAM,yBAAyB,GAAwB,IAAI,GAAG,CAAC;IAC7D,yBAAyB;IACzB,cAAc;IACd,eAAe;IACf,YAAY;IACZ,mBAAmB;IACnB,oBAAoB;IACpB,uBAAuB;IACvB,kBAAkB;IAClB,uBAAuB;IACvB,wBAAwB;IACxB,0BAA0B;IAC1B,kBAAkB;IAClB,oBAAoB;IACpB,wBAAwB;IACxB,yBAAyB;CAC1B,CAAC,CAAC;AAEH,MAAM,sBAAsB,GAAG,2BAA2B,CAAC;AAC3D,MAAM,uBAAuB,GAAG,4BAA4B,CAAC;AAQ7D,SAAS,UAAU,CAAC,GAAW,EAAE,OAA+B;IAC9D,IAAI,CAAC,OAAO,CAAC,YAAY,IAAI,wBAAwB,CAAC,GAAG,CAAC,GAAG,CAAC;QAAE,OAAO,IAAI,CAAC;IAC5E,OAAO,CAAC,OAAO,CAAC,aAAa,IAAI,yBAAyB,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;AACtE,CAAC;AAED,SAAS,oBAAoB,CAC3B,UAA6C,EAC7C,OAA+B;IAE/B,OAAO,CACL,CAAC,CAAC,OAAO,CAAC,YAAY,IAAI,UAAU,CAAC,sBAAsB,CAAC,KAAK,IAAI,CAAC;QACtE,CAAC,CAAC,OAAO,CAAC,aAAa,IAAI,UAAU,CAAC,uBAAuB,CAAC,KAAK,IAAI,CAAC,CACzE,CAAC;AACJ,CAAC;AAED,SAAS,sBAAsB,CAC7B,GAAW,EACX,KAAc,EACd,OAA+B;IAE/B,IAAI,GAAG,KAAK,sBAAsB,IAAI,KAAK,KAAK,IAAI,IAAI,CAAC,OAAO,CAAC,YAAY;QAAE,OAAO,KAAK,CAAC;IAC5F,IAAI,GAAG,KAAK,uBAAuB,IAAI,KAAK,KAAK,IAAI,IAAI,CAAC,OAAO,CAAC,aAAa;QAAE,OAAO,KAAK,CAAC;IAC9F,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,sBAAsB,CACpC,UAA6C,EAC7C,OAA+B;IAE/B,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IACrC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,UAAU,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC,IAAI,CAAC,oBAAoB,CAAC,UAAU,EAAE,OAAO,CAAC,EAAE,CAAC;QAChG,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,MAAM,IAAI,GAA4B,EAAE,CAAC;IACzC,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,IAAI,CAAC,UAAU,CAAC,GAAG,EAAE,OAAO,CAAC,EAAE,CAAC;YAC9B,IAAI,CAAC,GAAG,CAAC,GAAG,sBAAsB,CAAC,GAAG,EAAE,UAAU,CAAC,GAAG,CAAC,EAAE,OAAO,CAAC,CAAC;QACpE,CAAC;IACH,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/src/core/context.d.ts

@@ -0,0 +1,4 @@
+import type { ActiveOperation, AgentTelemetry, ExecutionContext } from "./types.js";
+/** Runs `execute` exactly once, even when the telemetry cannot enter the context. */
+export declare function runTraceContext<T>(telemetry: Pick<AgentTelemetry, "run" | "suppressed">, operation: ActiveOperation, execute: () => T, host?: ExecutionContext): T;
+//# sourceMappingURL=context.d.ts.map

package/dist/src/core/context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../../src/core/context.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAEpF,qFAAqF;AACrF,wBAAgB,eAAe,CAAC,CAAC,EAC/B,SAAS,EAAE,IAAI,CAAC,cAAc,EAAE,KAAK,GAAG,YAAY,CAAC,EACrD,SAAS,EAAE,eAAe,EAC1B,OAAO,EAAE,MAAM,CAAC,EAChB,IAAI,CAAC,EAAE,gBAAgB,GACtB,CAAC,CAyBH"}

package/dist/src/core/context.js

@@ -0,0 +1,28 @@
+/** Runs `execute` exactly once, even when the telemetry cannot enter the context. */
+export function runTraceContext(telemetry, operation, execute, host) {
+    let entered = false;
+    try {
+        return telemetry.run(operation, () => {
+            entered = true;
+            return execute();
+        }, host);
+    }
+    catch (error) {
+        if (entered)
+            throw error;
+        if (telemetry.suppressed !== undefined) {
+            try {
+                return telemetry.suppressed(() => {
+                    entered = true;
+                    return execute();
+                });
+            }
+            catch (error) {
+                if (entered)
+                    throw error;
+            }
+        }
+        return execute();
+    }
+}
+//# sourceMappingURL=context.js.map

package/dist/src/core/context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.js","sourceRoot":"","sources":["../../../src/core/context.ts"],"names":[],"mappings":"AAEA,qFAAqF;AACrF,MAAM,UAAU,eAAe,CAC7B,SAAqD,EACrD,SAA0B,EAC1B,OAAgB,EAChB,IAAuB;IAEvB,IAAI,OAAO,GAAG,KAAK,CAAC;IACpB,IAAI,CAAC;QACH,OAAO,SAAS,CAAC,GAAG,CAClB,SAAS,EACT,GAAG,EAAE;YACH,OAAO,GAAG,IAAI,CAAC;YACf,OAAO,OAAO,EAAE,CAAC;QACnB,CAAC,EACD,IAAI,CACL,CAAC;IACJ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,OAAO;YAAE,MAAM,KAAK,CAAC;QACzB,IAAI,SAAS,CAAC,UAAU,KAAK,SAAS,EAAE,CAAC;YACvC,IAAI,CAAC;gBACH,OAAO,SAAS,CAAC,UAAU,CAAC,GAAG,EAAE;oBAC/B,OAAO,GAAG,IAAI,CAAC;oBACf,OAAO,OAAO,EAAE,CAAC;gBACnB,CAAC,CAAC,CAAC;YACL,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,IAAI,OAAO;oBAAE,MAAM,KAAK,CAAC;YAC3B,CAAC;QACH,CAAC;QACD,OAAO,OAAO,EAAE,CAAC;IACnB,CAAC;AACH,CAAC"}

package/dist/src/core/delegation.d.ts

@@ -0,0 +1,14 @@
+import type { CaptureDecision, TraceReference } from "./types.js";
+export interface AgentHandoff {
+    readonly caller: TraceReference;
+    readonly conversationId: string;
+    readonly parentRunId: string;
+    readonly parentCallId: string;
+    readonly agentName: string;
+    readonly capture: CaptureDecision;
+    /** Set when the handoff crossed a process boundary; the callee then starts its own trace. */
+    readonly remote?: boolean;
+}
+export declare const currentAgentHandoff: () => AgentHandoff | undefined;
+export declare function withAgentHandoff<T>(handoff: AgentHandoff, execute: () => T): T;
+//# sourceMappingURL=delegation.d.ts.map

package/dist/src/core/delegation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"delegation.d.ts","sourceRoot":"","sources":["../../../src/core/delegation.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAElE,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,MAAM,EAAE,cAAc,CAAC;IAChC,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,OAAO,EAAE,eAAe,CAAC;IAClC,6FAA6F;IAC7F,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC;CAC3B;AAGD,eAAO,MAAM,mBAAmB,QACQ,YAAY,GAAG,SAAS,CAAC;AACjE,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,OAAO,EAAE,YAAY,EAAE,OAAO,EAAE,MAAM,CAAC,GAAG,CAAC,CAE9E"}

package/dist/src/core/delegation.js

@@ -0,0 +1,7 @@
+import { context, createContextKey } from "@opentelemetry/api";
+const HANDOFF = createContextKey("agent.tracing.handoff");
+export const currentAgentHandoff = () => context.active().getValue(HANDOFF);
+export function withAgentHandoff(handoff, execute) {
+    return context.with(context.active().setValue(HANDOFF, handoff), execute);
+}
+//# sourceMappingURL=delegation.js.map

package/dist/src/core/delegation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"delegation.js","sourceRoot":"","sources":["../../../src/core/delegation.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAc/D,MAAM,OAAO,GAAG,gBAAgB,CAAC,uBAAuB,CAAC,CAAC;AAC1D,MAAM,CAAC,MAAM,mBAAmB,GAAG,GAAG,EAAE,CACtC,OAAO,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,OAAO,CAA6B,CAAC;AACjE,MAAM,UAAU,gBAAgB,CAAI,OAAqB,EAAE,OAAgB;IACzE,OAAO,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC,EAAE,OAAO,CAAC,CAAC;AAC5E,CAAC"}

package/dist/src/core/mcp.d.ts

@@ -0,0 +1,25 @@
+import type { Attributes } from "./types.js";
+import type { ContentSerializer } from "./types.js";
+export interface McpUpdate {
+    readonly connectionName?: string;
+    readonly method?: string;
+    readonly toolName?: string;
+    readonly protocolVersion?: string;
+    readonly requestId?: string;
+    readonly sessionId?: string;
+    readonly statusCode?: string | number;
+}
+export interface McpLifecycle {
+    update(input: McpUpdate): void;
+    error(error?: unknown, type?: string): void;
+    arguments(value: unknown): void;
+    result(value: unknown): void;
+}
+export declare function mcpLifecycle(input: {
+    readonly write: (attributes: Attributes) => void;
+    readonly error: (error?: unknown, type?: string) => void;
+    readonly serializer: ContentSerializer;
+    readonly recordInputs: boolean;
+    readonly recordOutputs: boolean;
+}): McpLifecycle;
+//# sourceMappingURL=mcp.d.ts.map

package/dist/src/core/mcp.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp.d.ts","sourceRoot":"","sources":["../../../src/core/mcp.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAC7C,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAEpD,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;CACvC;AAED,MAAM,WAAW,YAAY;IAC3B,MAAM,CAAC,KAAK,EAAE,SAAS,GAAG,IAAI,CAAC;IAC/B,KAAK,CAAC,KAAK,CAAC,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5C,SAAS,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI,CAAC;IAChC,MAAM,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI,CAAC;CAC9B;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE;IAClC,QAAQ,CAAC,KAAK,EAAE,CAAC,UAAU,EAAE,UAAU,KAAK,IAAI,CAAC;IACjD,QAAQ,CAAC,KAAK,EAAE,CAAC,KAAK,CAAC,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;IACzD,QAAQ,CAAC,UAAU,EAAE,iBAAiB,CAAC;IACvC,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAC;IAC/B,QAAQ,CAAC,aAAa,EAAE,OAAO,CAAC;CACjC,GAAG,YAAY,CAiCf"}

package/dist/src/core/mcp.js

@@ -0,0 +1,33 @@
+export function mcpLifecycle(input) {
+    return {
+        update(update) {
+            if (update.connectionName !== undefined && update.method !== undefined)
+                input.write({
+                    "agent.connection.name": update.connectionName,
+                    "mcp.method.name": update.method,
+                    "network.protocol.name": "http",
+                    "network.transport": "tcp",
+                    "mcp.protocol.version": update.protocolVersion,
+                    "jsonrpc.request.id": update.requestId,
+                    "gen_ai.operation.name": update.method === "tools/call" ? "execute_tool" : undefined,
+                    "gen_ai.tool.name": update.method === "tools/call" ? update.toolName : undefined,
+                });
+            if (update.sessionId !== undefined)
+                input.write({ "mcp.session.id": update.sessionId });
+            if (update.statusCode !== undefined)
+                input.write({ "rpc.response.status_code": update.statusCode });
+        },
+        error(error, type) {
+            input.error(input.recordOutputs ? error : undefined, type ?? (error instanceof Error ? error.name : undefined));
+        },
+        arguments(value) {
+            if (input.recordInputs)
+                input.write({ "gen_ai.tool.call.arguments": input.serializer.json(value) });
+        },
+        result(value) {
+            if (input.recordOutputs)
+                input.write({ "gen_ai.tool.call.result": input.serializer.json(value) });
+        },
+    };
+}
+//# sourceMappingURL=mcp.js.map

package/dist/src/core/mcp.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp.js","sourceRoot":"","sources":["../../../src/core/mcp.ts"],"names":[],"mappings":"AAoBA,MAAM,UAAU,YAAY,CAAC,KAM5B;IACC,OAAO;QACL,MAAM,CAAC,MAAM;YACX,IAAI,MAAM,CAAC,cAAc,KAAK,SAAS,IAAI,MAAM,CAAC,MAAM,KAAK,SAAS;gBACpE,KAAK,CAAC,KAAK,CAAC;oBACV,uBAAuB,EAAE,MAAM,CAAC,cAAc;oBAC9C,iBAAiB,EAAE,MAAM,CAAC,MAAM;oBAChC,uBAAuB,EAAE,MAAM;oBAC/B,mBAAmB,EAAE,KAAK;oBAC1B,sBAAsB,EAAE,MAAM,CAAC,eAAe;oBAC9C,oBAAoB,EAAE,MAAM,CAAC,SAAS;oBACtC,uBAAuB,EAAE,MAAM,CAAC,MAAM,KAAK,YAAY,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,SAAS;oBACpF,kBAAkB,EAAE,MAAM,CAAC,MAAM,KAAK,YAAY,CAAC,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,SAAS;iBACjF,CAAC,CAAC;YACL,IAAI,MAAM,CAAC,SAAS,KAAK,SAAS;gBAAE,KAAK,CAAC,KAAK,CAAC,EAAE,gBAAgB,EAAE,MAAM,CAAC,SAAS,EAAE,CAAC,CAAC;YACxF,IAAI,MAAM,CAAC,UAAU,KAAK,SAAS;gBACjC,KAAK,CAAC,KAAK,CAAC,EAAE,0BAA0B,EAAE,MAAM,CAAC,UAAU,EAAE,CAAC,CAAC;QACnE,CAAC;QACD,KAAK,CAAC,KAAK,EAAE,IAAI;YACf,KAAK,CAAC,KAAK,CACT,KAAK,CAAC,aAAa,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,EACvC,IAAI,IAAI,CAAC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,CAC1D,CAAC;QACJ,CAAC;QACD,SAAS,CAAC,KAAK;YACb,IAAI,KAAK,CAAC,YAAY;gBACpB,KAAK,CAAC,KAAK,CAAC,EAAE,4BAA4B,EAAE,KAAK,CAAC,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QAChF,CAAC;QACD,MAAM,CAAC,KAAK;YACV,IAAI,KAAK,CAAC,aAAa;gBACrB,KAAK,CAAC,KAAK,CAAC,EAAE,yBAAyB,EAAE,KAAK,CAAC,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QAC7E,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/src/core/scopes.d.ts

@@ -0,0 +1,60 @@
+import { type McpLifecycle } from "./mcp.js";
+import type { AgentTelemetry, CaptureDecision, ContentSerializer, ExecutionContext, Operation, ScopeData, ScopeIdentity, ScopeRecord, ScopeTerminal, TraceErrorHandler, TraceLink, TraceReference, Usage } from "./types.js";
+export interface ChildOptions {
+    readonly links?: readonly TraceLink[];
+    readonly startTimeMs?: number;
+}
+export interface LiveOperation extends Operation {
+    child(data: ScopeData, key?: string, options?: ChildOptions): Promise<LiveOperation>;
+    /** Returns an unsettled child with this identity, without starting one. */
+    find(data: ScopeData): LiveOperation | undefined;
+    /** Unsettled children, in start order. */
+    readonly children: readonly LiveOperation[];
+    usage(usage: Usage, key?: string): Promise<void>;
+    /** Carries a model call's messages up to its turn: the first input and the latest output. */
+    turnContent(content: {
+        readonly input?: string;
+        readonly output?: string;
+    }): void;
+    error(error?: unknown, type?: string): void;
+    /** Replaces the host context for this operation and its descendants. */
+    useContext(context: ExecutionContext): void;
+    /** Fills in a deferred operation's details from a later call with the same identity. */
+    refine(data: ScopeData, startTimeMs?: number): void;
+    /** Lowers capture for this operation and its children, and drops retained content it no longer allows. */
+    narrow(capture: CaptureDecision): void;
+    /** Completes this operation, or closes the open descendants of a finished one. */
+    release(result: ScopeTerminal): Promise<void>;
+    /** Finished, with no unfinished descendants. */
+    readonly settled: boolean;
+    readonly callId?: string;
+    readonly mcp: McpLifecycle;
+    record(): ScopeRecord;
+}
+export declare function createScopes(input: {
+    readonly telemetry: AgentTelemetry;
+    readonly serializer: ContentSerializer;
+    readonly durable: boolean;
+    readonly onError?: TraceErrorHandler;
+}): {
+    /** Starts a turn tree. Durable turns reserve their IDs from `key`. */
+    start(facts: {
+        identity: ScopeIdentity;
+        key: string;
+        capture: CaptureDecision;
+        data: ScopeData;
+        parent?: TraceReference;
+        reference?: TraceReference;
+        startTimeMs?: number;
+        links?: readonly TraceLink[];
+        context?: ExecutionContext;
+        onChange?: () => Promise<void>;
+    }): Promise<LiveOperation>;
+    /** Rebuilds a tree from a checkpoint, or returns `undefined` for an unusable one. */
+    restore(snapshot: unknown, options?: {
+        capture?: CaptureDecision;
+        context?: ExecutionContext;
+        onChange?: () => Promise<void>;
+    }): Promise<LiveOperation | undefined>;
+};
+//# sourceMappingURL=scopes.d.ts.map

package/dist/src/core/scopes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scopes.d.ts","sourceRoot":"","sources":["../../../src/core/scopes.ts"],"names":[],"mappings":"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"}