@introspection-sdk/introspection-pi 0.7.1 → 0.8.0

package/README.md

@@ -19,6 +19,7 @@ npm install @introspection-sdk/introspection-pi \
 ```ts
 import { trace } from "@opentelemetry/api";
 import { Agent } from "@earendil-works/pi-agent-core";
+import { getBuiltinModel } from "@earendil-works/pi-ai/providers/all";
 import {
   instrumentAgent,
   instrumentStream,
@@ -32,7 +33,12 @@ const meta: AgentMeta = {
   agentName: "Support",
 };
 
-const agent = new Agent({/* … */});
+const agent = new Agent({
+  initialState: {
+    model: getBuiltinModel("anthropic", "claude-sonnet-4-6"),
+    systemPrompt: "You are a helpful support agent.",
+  },
+});
 
 // One chat span per LLM call
 agent.streamFn = instrumentStream(agent.streamFn, { tracer, meta });
@@ -40,6 +46,8 @@ agent.streamFn = instrumentStream(agent.streamFn, { tracer, meta });
 // One execute_tool span per tool call
 const tools = instrumentAgent(agent, { tracer, meta });
 
+await agent.prompt("Help me understand my latest invoice.");
+
 // Later, on shutdown:
 tools.stop();
 ```

package/dist/attributes.d.ts

@@ -8,6 +8,11 @@
 import type { Attributes } from "@opentelemetry/api";
 import type { AssistantMessage, Context, Model, SimpleStreamOptions } from "@earendil-works/pi-ai";
 import { type ConvertOptions } from "./convert.js";
+/**
+ * `server.address` / `server.port` derived from the model's base URL.
+ * Returns an empty record when the URL cannot be parsed.
+ */
+export declare function serverAttributes(baseUrl: string): Attributes;
 /** Metadata that the consumer attaches to every chat / tool span. */
 export interface AgentMeta {
     conversationId: string;
@@ -27,7 +32,16 @@ export declare function chatRequestAttributes(model: Model<string>, context: Con
  */
 export declare function chatResponseAttributes(message: AssistantMessage): Attributes;
 /** Common attributes for an execute_tool span (set at start). */
-export declare function executeToolAttributes(toolName: string, toolCallId: string, args: unknown, meta: AgentMeta): Attributes;
+export declare function executeToolAttributes(toolName: string, toolCallId: string, args: unknown, meta: AgentMeta, description?: string): Attributes;
+/**
+ * Attributes for an `invoke_agent` span (set at start).
+ *
+ * Per the semconv agent-span table for in-process invocation, model and
+ * provider are intentionally NOT recorded: pi agents can switch models
+ * mid-run, and the spec says `gen_ai.request.model` SHOULD NOT be
+ * populated for agents that support dynamic model selection.
+ */
+export declare function invokeAgentAttributes(meta: AgentMeta): Attributes;
 /** Result attribute for an execute_tool span (set at end). */
 export declare function executeToolResultAttribute(result: unknown): Attributes;
 export {};

package/dist/attributes.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"attributes.d.ts","sourceRoot":"","sources":["../src/attributes.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,KAAK,EACV,gBAAgB,EAChB,OAAO,EACP,KAAK,EACL,mBAAmB,EAEpB,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EAIL,KAAK,cAAc,EACpB,MAAM,cAAc,CAAC;AAItB,qEAAqE;AACrE,MAAM,WAAW,SAAS;IACxB,cAAc,EAAE,MAAM,CAAC;IACvB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,UAAU,2BAA4B,SAAQ,cAAc;IAC1D,aAAa,CAAC,EAAE,IAAI,CAClB,mBAAmB,EACnB,aAAa,GAAG,WAAW,GAAG,WAAW,CAC1C,CAAC;CACH;AAED,oFAAoF;AACpF,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,KAAK,CAAC,MAAM,CAAC,EACpB,OAAO,EAAE,OAAO,EAChB,IAAI,EAAE,SAAS,EACf,OAAO,CAAC,EAAE,2BAA2B,GACpC,UAAU,CAiDZ;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,gBAAgB,GAAG,UAAU,CAyC5E;AAED,iEAAiE;AACjE,wBAAgB,qBAAqB,CACnC,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,OAAO,EACb,IAAI,EAAE,SAAS,GACd,UAAU,CAcZ;AAED,8DAA8D;AAC9D,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,OAAO,GAAG,UAAU,CAGtE"}
+{"version":3,"file":"attributes.d.ts","sourceRoot":"","sources":["../src/attributes.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,KAAK,EACV,gBAAgB,EAChB,OAAO,EACP,KAAK,EACL,mBAAmB,EAEpB,MAAM,uBAAuB,CAAC;AAO/B,OAAO,EAKL,KAAK,cAAc,EACpB,MAAM,cAAc,CAAC;AAItB;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,UAAU,CAY5D;AAED,qEAAqE;AACrE,MAAM,WAAW,SAAS;IACxB,cAAc,EAAE,MAAM,CAAC;IACvB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,UAAU,2BAA4B,SAAQ,cAAc;IAC1D,aAAa,CAAC,EAAE,IAAI,CAClB,mBAAmB,EACnB,aAAa,GAAG,WAAW,GAAG,WAAW,CAC1C,CAAC;CACH;AAED,oFAAoF;AACpF,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,KAAK,CAAC,MAAM,CAAC,EACpB,OAAO,EAAE,OAAO,EAChB,IAAI,EAAE,SAAS,EACf,OAAO,CAAC,EAAE,2BAA2B,GACpC,UAAU,CAwDZ;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,gBAAgB,GAAG,UAAU,CAyC5E;AAED,iEAAiE;AACjE,wBAAgB,qBAAqB,CACnC,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,OAAO,EACb,IAAI,EAAE,SAAS,EACf,WAAW,CAAC,EAAE,MAAM,GACnB,UAAU,CAiBZ;AAED;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,SAAS,GAAG,UAAU,CAOjE;AAED,8DAA8D;AAC9D,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,OAAO,GAAG,UAAU,CAGtE"}

package/dist/attributes.js

@@ -5,9 +5,27 @@
  * can inspect, log, and merge with their own attributes (`extraAttributes`
  * hook, environment-derived tenant labels, etc.).
  */
-import { GenAi } from "@introspection-sdk/types";
-import { assistantToOutputMessages, messagesToInputMessages, systemPromptToInstructions, } from "./convert.js";
+import { GenAi, } from "@introspection-sdk/types";
+import { assistantToOutputMessages, messagesToInputMessages, semconvFinishReason, systemPromptToInstructions, } from "./convert.js";
 const MAX_BYTES = 64_000;
+/**
+ * `server.address` / `server.port` derived from the model's base URL.
+ * Returns an empty record when the URL cannot be parsed.
+ */
+export function serverAttributes(baseUrl) {
+    try {
+        const url = new URL(baseUrl);
+        const port = url.port
+            ? Number(url.port)
+            : url.protocol === "http:"
+                ? 80
+                : 443;
+        return { "server.address": url.hostname, "server.port": port };
+    }
+    catch {
+        return {};
+    }
+}
 /** Attributes set on a chat span at request time, before the model has streamed. */
 export function chatRequestAttributes(model, context, meta, options) {
     const attributes = {
@@ -18,6 +36,7 @@ export function chatRequestAttributes(model, context, meta, options) {
         [GenAi.PROVIDER_NAME]: model.provider,
         [GenAi.REQUEST_MODEL]: model.id,
         "gen_ai.request.stream": true,
+        ...serverAttributes(model.baseUrl),
     };
     if (context.systemPrompt) {
         const serialized = serializeWithCap(() => JSON.stringify(systemPromptToInstructions(context.systemPrompt)), () => undefined, GenAi.SYSTEM_INSTRUCTIONS);
@@ -30,7 +49,10 @@ export function chatRequestAttributes(model, context, meta, options) {
         attributes[GenAi.TOOL_DEFINITIONS] = toolDefinitions;
     }
     const inputMessages = messagesToInputMessages(context.messages, options);
-    attributes[GenAi.INPUT_MESSAGES] = JSON.stringify(inputMessages);
+    const serializedInput = serializeMessagesWithCap(inputMessages, GenAi.INPUT_MESSAGES);
+    if (serializedInput) {
+        attributes[GenAi.INPUT_MESSAGES] = serializedInput;
+    }
     if (inputMessages.some((message) => message.parts.some((part) => part.type === "compaction"))) {
         attributes["gen_ai.conversation.compacted"] = true;
     }
@@ -55,11 +77,17 @@ export function chatRequestAttributes(model, context, meta, options) {
  */
 export function chatResponseAttributes(message) {
     const attributes = {
-        [GenAi.OUTPUT_MESSAGES]: JSON.stringify(assistantToOutputMessages(message)),
-        [GenAi.RESPONSE_FINISH_REASONS]: [message.stopReason],
-        [GenAi.USAGE_INPUT_TOKENS]: message.usage.input,
+        [GenAi.RESPONSE_FINISH_REASONS]: [semconvFinishReason(message.stopReason)],
+        // Anthropic reports uncached, cache-read, and cache-creation input
+        // separately. Semconv defines both cache attributes as subsets of the
+        // total input token count.
+        [GenAi.USAGE_INPUT_TOKENS]: message.usage.input + message.usage.cacheRead + message.usage.cacheWrite,
         [GenAi.USAGE_OUTPUT_TOKENS]: message.usage.output,
     };
+    const serializedOutput = serializeMessagesWithCap(assistantToOutputMessages(message), GenAi.OUTPUT_MESSAGES);
+    if (serializedOutput) {
+        attributes[GenAi.OUTPUT_MESSAGES] = serializedOutput;
+    }
     if (message.usage.cacheRead > 0) {
         attributes[GenAi.USAGE_CACHE_READ_INPUT_TOKENS] = message.usage.cacheRead;
     }
@@ -70,10 +98,9 @@ export function chatResponseAttributes(message) {
     if (message.usage.cost?.total) {
         attributes[GenAi.COST_USD] = message.usage.cost.total;
     }
-    const reasoningOutputTokens = message.usage.reasoningOutputTokens ??
-        message.usage.reasoningOutput;
-    if (typeof reasoningOutputTokens === "number" && reasoningOutputTokens > 0) {
-        attributes["gen_ai.usage.reasoning.output_tokens"] = reasoningOutputTokens;
+    const reasoningTokens = message.usage.reasoning;
+    if (typeof reasoningTokens === "number" && reasoningTokens > 0) {
+        attributes[GenAi.USAGE_REASONING_TOKENS] = reasoningTokens;
     }
     if (message.responseId) {
         attributes[GenAi.RESPONSE_ID] = message.responseId;
@@ -84,7 +111,7 @@ export function chatResponseAttributes(message) {
     return attributes;
 }
 /** Common attributes for an execute_tool span (set at start). */
-export function executeToolAttributes(toolName, toolCallId, args, meta) {
+export function executeToolAttributes(toolName, toolCallId, args, meta, description) {
     const attributes = {
         [GenAi.CONVERSATION_ID]: meta.conversationId,
         [GenAi.AGENT_ID]: meta.agentId,
@@ -94,11 +121,30 @@ export function executeToolAttributes(toolName, toolCallId, args, meta) {
         [GenAi.TOOL_TYPE]: "function",
         [GenAi.TOOL_CALL_ID]: toolCallId,
     };
+    if (description) {
+        attributes[GenAi.TOOL_DESCRIPTION] = description;
+    }
     if (args !== undefined) {
         attributes[GenAi.TOOL_CALL_ARGUMENTS] = stringify(args);
     }
     return attributes;
 }
+/**
+ * Attributes for an `invoke_agent` span (set at start).
+ *
+ * Per the semconv agent-span table for in-process invocation, model and
+ * provider are intentionally NOT recorded: pi agents can switch models
+ * mid-run, and the spec says `gen_ai.request.model` SHOULD NOT be
+ * populated for agents that support dynamic model selection.
+ */
+export function invokeAgentAttributes(meta) {
+    return {
+        [GenAi.CONVERSATION_ID]: meta.conversationId,
+        [GenAi.AGENT_ID]: meta.agentId,
+        [GenAi.AGENT_NAME]: meta.agentName,
+        [GenAi.OPERATION_NAME]: "invoke_agent",
+    };
+}
 /** Result attribute for an execute_tool span (set at end). */
 export function executeToolResultAttribute(result) {
     if (result === undefined)
@@ -112,11 +158,44 @@ function serializeToolDefinitions(tools) {
     if (!tools || tools.length === 0)
         return undefined;
     const detailed = tools.map((tool) => ({
+        type: "function",
         name: tool.name,
         description: tool.description,
         parameters: tool.parameters,
     }));
-    return serializeWithCap(() => JSON.stringify(detailed.map((def) => ({ type: "function", ...def }))), () => JSON.stringify(detailed.map((def) => ({ type: "function", name: def.name }))), GenAi.TOOL_DEFINITIONS);
+    return serializeWithCap(() => JSON.stringify(detailed), () => JSON.stringify(detailed.map((def) => ({ type: def.type, name: def.name }))), GenAi.TOOL_DEFINITIONS);
+}
+/**
+ * Cap chars per part-content string in the truncation fallback for
+ * `gen_ai.input.messages` / `gen_ai.output.messages`. Chosen so even long
+ * transcripts stay within MAX_BYTES once every part is clamped.
+ */
+const MAX_PART_CONTENT_CHARS = 8_000;
+/**
+ * Serialize an input/output message array under the size cap, per the
+ * semconv guidance that instrumentations may truncate individual message
+ * contents while preserving JSON structure: full payload first, then a
+ * fallback with each part's content clamped, then drop the attribute.
+ */
+function serializeMessagesWithCap(messages, attributeName) {
+    return serializeWithCap(() => JSON.stringify(messages), () => JSON.stringify(messages.map(truncateMessageParts)), attributeName);
+}
+function truncateMessageParts(message) {
+    return {
+        ...message,
+        parts: message.parts.map((part) => {
+            const truncated = { ...part };
+            for (const key of ["content", "response"]) {
+                const value = truncated[key];
+                if (typeof value === "string" &&
+                    value.length > MAX_PART_CONTENT_CHARS) {
+                    truncated[key] =
+                        value.slice(0, MAX_PART_CONTENT_CHARS) + "…[truncated]";
+                }
+            }
+            return truncated;
+        }),
+    };
 }
 /**
  * Try the detailed serializer; if it exceeds the cap, try a compact fallback;

package/dist/attributes.js.map

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

package/dist/convert.d.ts

@@ -27,6 +27,14 @@ export declare function messagesToInputMessages(messages: readonly Message[], op
 export declare function assistantToOutputMessages(message: AssistantMessage): OutputMessage[];
 /** Wrap a system prompt in the semconv shape used for `gen_ai.system_instructions`. */
 export declare function systemPromptToInstructions(systemPrompt: string): SystemInstruction[];
+/**
+ * Map a pi-ai stop reason to the semconv `FinishReason` value
+ * (gen-ai-output-messages.json). Only `"toolUse"` needs translation — the
+ * schema enum calls it `"tool_call"`. The remaining pi values are either
+ * enum members already (`stop`, `length`, `error`) or intentionally kept
+ * as custom strings (`aborted`; the schema allows free-form values).
+ */
+export declare function semconvFinishReason(stopReason: string): string;
 /**
  * Hydrate an array of semconv messages back into pi-ai `Message[]`.
  *

package/dist/convert.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"convert.d.ts","sourceRoot":"","sources":["../src/convert.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EACV,gBAAgB,EAEhB,OAAO,EAMR,MAAM,uBAAuB,CAAC;AAC/B,OAAO,KAAK,EAEV,YAAY,EAEZ,aAAa,EAEb,iBAAiB,EAIlB,MAAM,0BAA0B,CAAC;AAqBlC,kDAAkD;AAClD,MAAM,WAAW,cAAc;IAC7B;;;;;;;;;OASG;IACH,mBAAmB,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CACzC;AAMD,iFAAiF;AACjF,wBAAgB,uBAAuB,CACrC,QAAQ,EAAE,SAAS,OAAO,EAAE,EAC5B,OAAO,CAAC,EAAE,cAAc,GACvB,YAAY,EAAE,CAOhB;AAED,2EAA2E;AAC3E,wBAAgB,yBAAyB,CACvC,OAAO,EAAE,gBAAgB,GACxB,aAAa,EAAE,CAGjB;AAED,uFAAuF;AACvF,wBAAgB,0BAA0B,CACxC,YAAY,EAAE,MAAM,GACnB,iBAAiB,EAAE,CAErB;AAiMD;;;;;;;;;;GAUG;AACH,wBAAgB,uBAAuB,CACrC,QAAQ,EAAE,SAAS,YAAY,EAAE,GAChC,OAAO,EAAE,CAoEX"}
+{"version":3,"file":"convert.d.ts","sourceRoot":"","sources":["../src/convert.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EACV,gBAAgB,EAEhB,OAAO,EAMR,MAAM,uBAAuB,CAAC;AAC/B,OAAO,KAAK,EAGV,YAAY,EAEZ,aAAa,EAEb,iBAAiB,EAIlB,MAAM,0BAA0B,CAAC;AAqBlC,kDAAkD;AAClD,MAAM,WAAW,cAAc;IAC7B;;;;;;;;;OASG;IACH,mBAAmB,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CACzC;AAMD,iFAAiF;AACjF,wBAAgB,uBAAuB,CACrC,QAAQ,EAAE,SAAS,OAAO,EAAE,EAC5B,OAAO,CAAC,EAAE,cAAc,GACvB,YAAY,EAAE,CAOhB;AAED,2EAA2E;AAC3E,wBAAgB,yBAAyB,CACvC,OAAO,EAAE,gBAAgB,GACxB,aAAa,EAAE,CAGjB;AAED,uFAAuF;AACvF,wBAAgB,0BAA0B,CACxC,YAAY,EAAE,MAAM,GACnB,iBAAiB,EAAE,CAErB;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAE9D;AAyND;;;;;;;;;;GAUG;AACH,wBAAgB,uBAAuB,CACrC,QAAQ,EAAE,SAAS,YAAY,EAAE,GAChC,OAAO,EAAE,CAoEX"}

package/dist/convert.js

@@ -44,6 +44,16 @@ export function assistantToOutputMessages(message) {
 export function systemPromptToInstructions(systemPrompt) {
     return [{ type: "text", content: systemPrompt }];
 }
+/**
+ * Map a pi-ai stop reason to the semconv `FinishReason` value
+ * (gen-ai-output-messages.json). Only `"toolUse"` needs translation — the
+ * schema enum calls it `"tool_call"`. The remaining pi values are either
+ * enum members already (`stop`, `length`, `error`) or intentionally kept
+ * as custom strings (`aborted`; the schema allows free-form values).
+ */
+export function semconvFinishReason(stopReason) {
+    return stopReason === "toolUse" ? "tool_call" : stopReason;
+}
 function messageToSemconv(message, options) {
     switch (message.role) {
         case "user":
@@ -69,10 +79,35 @@ function userMessageToSemconv(message, options) {
             parts: [{ type: "compaction", content: summary }],
         };
     }
-    return {
-        role: "user",
-        parts: [{ type: "text", content: text }],
-    };
+    if (typeof message.content === "string") {
+        return {
+            role: "user",
+            parts: [{ type: "text", content: message.content }],
+        };
+    }
+    // Block-array content: preserve part order, including image payloads.
+    // The bounded message serializer truncates oversized content later.
+    const parts = [];
+    for (const block of message.content) {
+        if (block.type === "text") {
+            if (block.text)
+                parts.push({ type: "text", content: block.text });
+        }
+        else {
+            const blob = {
+                type: "blob",
+                modality: "image",
+                content: block.data,
+            };
+            if (block.mimeType)
+                blob.mime_type = block.mimeType;
+            parts.push(blob);
+        }
+    }
+    if (parts.length === 0) {
+        parts.push({ type: "text", content: "" });
+    }
+    return { role: "user", parts };
 }
 /**
  * Identify a user message as a rendered compaction summary.
@@ -105,8 +140,9 @@ function assistantMessageToSemconv(message) {
             parts.push(part);
     }
     const result = { parts };
-    if (message.stopReason)
-        result.finish_reason = message.stopReason;
+    if (message.stopReason) {
+        result.finish_reason = semconvFinishReason(message.stopReason);
+    }
     if (message.api)
         result.api = message.api;
     if (message.provider)
@@ -163,7 +199,7 @@ function assistantBlockToPart(block) {
             if (!block.thinking && !block.thinkingSignature)
                 return null;
             const part = {
-                type: "thinking",
+                type: "reasoning",
                 content: block.thinking ?? "",
             };
             if (block.thinkingSignature) {
@@ -401,7 +437,7 @@ function isCompactionPart(part) {
     return part.type === "compaction";
 }
 function isReasoningPart(part) {
-    return part.type === "thinking";
+    return part.type === "reasoning";
 }
 function isToolCallRequestPart(part) {
     return part.type === "tool_call";

package/dist/convert.js.map

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

package/dist/error-type.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Best-effort `error.type` classification per the semconv guidance: prefer
+ * the provider's error code (HTTP status) or the canonical exception name,
+ * falling back to a documented low-cardinality label.
+ *
+ * Values this instrumentation reports:
+ * - a 4xx/5xx HTTP status extracted from the provider error message
+ * - the thrown exception's class name (when it is a subclass of Error)
+ * - `"model_error"` — the stream ended with a provider-reported error
+ * - `"exception"` — the stream function itself threw
+ * - `"tool_error"` — a tool execution returned an error result
+ */
+export declare function classifyErrorType(message: string | undefined, fallback: string): string;
+/** classifyErrorType for a thrown value: status code → class name → fallback. */
+export declare function classifyThrownErrorType(error: unknown): string;
+//# sourceMappingURL=error-type.d.ts.map

package/dist/error-type.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-type.d.ts","sourceRoot":"","sources":["../src/error-type.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,MAAM,GAAG,SAAS,EAC3B,QAAQ,EAAE,MAAM,GACf,MAAM,CAMR;AAED,iFAAiF;AACjF,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAQ9D"}

package/dist/error-type.js

@@ -0,0 +1,32 @@
+/**
+ * Best-effort `error.type` classification per the semconv guidance: prefer
+ * the provider's error code (HTTP status) or the canonical exception name,
+ * falling back to a documented low-cardinality label.
+ *
+ * Values this instrumentation reports:
+ * - a 4xx/5xx HTTP status extracted from the provider error message
+ * - the thrown exception's class name (when it is a subclass of Error)
+ * - `"model_error"` — the stream ended with a provider-reported error
+ * - `"exception"` — the stream function itself threw
+ * - `"tool_error"` — a tool execution returned an error result
+ */
+export function classifyErrorType(message, fallback) {
+    if (message) {
+        const status = /\b([45]\d{2})\b/.exec(message);
+        if (status?.[1])
+            return status[1];
+    }
+    return fallback;
+}
+/** classifyErrorType for a thrown value: status code → class name → fallback. */
+export function classifyThrownErrorType(error) {
+    const message = error instanceof Error ? error.message : String(error);
+    const status = /\b([45]\d{2})\b/.exec(message);
+    if (status?.[1])
+        return status[1];
+    if (error instanceof Error && error.name && error.name !== "Error") {
+        return error.name;
+    }
+    return "exception";
+}
+//# sourceMappingURL=error-type.js.map

package/dist/error-type.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-type.js","sourceRoot":"","sources":["../src/error-type.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,iBAAiB,CAC/B,OAA2B,EAC3B,QAAgB;IAEhB,IAAI,OAAO,EAAE,CAAC;QACZ,MAAM,MAAM,GAAG,iBAAiB,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAC/C,IAAI,MAAM,EAAE,CAAC,CAAC,CAAC;YAAE,OAAO,MAAM,CAAC,CAAC,CAAC,CAAC;IACpC,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,iFAAiF;AACjF,MAAM,UAAU,uBAAuB,CAAC,KAAc;IACpD,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IACvE,MAAM,MAAM,GAAG,iBAAiB,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAC/C,IAAI,MAAM,EAAE,CAAC,CAAC,CAAC;QAAE,OAAO,MAAM,CAAC,CAAC,CAAC,CAAC;IAClC,IAAI,KAAK,YAAY,KAAK,IAAI,KAAK,CAAC,IAAI,IAAI,KAAK,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC;QACnE,OAAO,KAAK,CAAC,IAAI,CAAC;IACpB,CAAC;IACD,OAAO,WAAW,CAAC;AACrB,CAAC"}

package/dist/index.d.ts

@@ -5,7 +5,9 @@
  * (`@earendil-works/pi-ai`, `@earendil-works/pi-agent-core`).
  *
  * Emits OTel GenAI semantic-convention spans for chat completions
- * (`chat ${provider}`) and tool execution (`execute_tool ${tool_name}`).
+ * (`chat ${model}`), tool execution (`execute_tool ${tool_name}`), and —
+ * optionally — agent runs (`invoke_agent ${agent_name}`), plus the GenAI
+ * client metrics when a meter is provided.
  *
  * @example
  * ```ts
@@ -19,8 +21,9 @@
  */
 export { instrumentStream, type InstrumentStreamOptions, } from "./instrument-stream.js";
 export { instrumentAgent, type AgentInstrumentation, type InstrumentAgentOptions, } from "./instrument-agent.js";
-export { chatRequestAttributes, chatResponseAttributes, executeToolAttributes, executeToolResultAttribute, type AgentMeta, } from "./attributes.js";
-export { assistantToOutputMessages, inputMessagesToMessages, messagesToInputMessages, systemPromptToInstructions, type ConvertOptions, } from "./convert.js";
+export { chatRequestAttributes, chatResponseAttributes, executeToolAttributes, executeToolResultAttribute, invokeAgentAttributes, serverAttributes, type AgentMeta, } from "./attributes.js";
+export { genAiMetrics, type GenAiMetrics } from "./metrics.js";
+export { assistantToOutputMessages, inputMessagesToMessages, messagesToInputMessages, semconvFinishReason, systemPromptToInstructions, type ConvertOptions, } from "./convert.js";
 export type { AbortTerminationReason, GenAiAttributes, InputMessage, MessagePart, MessageRole, OutputMessage, ReasoningPart, SystemInstruction, TextPart, ToolCallRequestPart, ToolCallResponsePart, ToolDefinition, } from "@introspection-sdk/types";
 export { GenAi, GenAiSpanName, IntrospectionAttr, toAttributes, } from "@introspection-sdk/types";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAGH,OAAO,EACL,gBAAgB,EAChB,KAAK,uBAAuB,GAC7B,MAAM,wBAAwB,CAAC;AAChC,OAAO,EACL,eAAe,EACf,KAAK,oBAAoB,EACzB,KAAK,sBAAsB,GAC5B,MAAM,uBAAuB,CAAC;AAG/B,OAAO,EACL,qBAAqB,EACrB,sBAAsB,EACtB,qBAAqB,EACrB,0BAA0B,EAC1B,KAAK,SAAS,GACf,MAAM,iBAAiB,CAAC;AAKzB,OAAO,EACL,yBAAyB,EACzB,uBAAuB,EACvB,uBAAuB,EACvB,0BAA0B,EAC1B,KAAK,cAAc,GACpB,MAAM,cAAc,CAAC;AAGtB,YAAY,EACV,sBAAsB,EACtB,eAAe,EACf,YAAY,EACZ,WAAW,EACX,WAAW,EACX,aAAa,EACb,aAAa,EACb,iBAAiB,EACjB,QAAQ,EACR,mBAAmB,EACnB,oBAAoB,EACpB,cAAc,GACf,MAAM,0BAA0B,CAAC;AAClC,OAAO,EACL,KAAK,EACL,aAAa,EACb,iBAAiB,EACjB,YAAY,GACb,MAAM,0BAA0B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAGH,OAAO,EACL,gBAAgB,EAChB,KAAK,uBAAuB,GAC7B,MAAM,wBAAwB,CAAC;AAChC,OAAO,EACL,eAAe,EACf,KAAK,oBAAoB,EACzB,KAAK,sBAAsB,GAC5B,MAAM,uBAAuB,CAAC;AAG/B,OAAO,EACL,qBAAqB,EACrB,sBAAsB,EACtB,qBAAqB,EACrB,0BAA0B,EAC1B,qBAAqB,EACrB,gBAAgB,EAChB,KAAK,SAAS,GACf,MAAM,iBAAiB,CAAC;AAGzB,OAAO,EAAE,YAAY,EAAE,KAAK,YAAY,EAAE,MAAM,cAAc,CAAC;AAK/D,OAAO,EACL,yBAAyB,EACzB,uBAAuB,EACvB,uBAAuB,EACvB,mBAAmB,EACnB,0BAA0B,EAC1B,KAAK,cAAc,GACpB,MAAM,cAAc,CAAC;AAGtB,YAAY,EACV,sBAAsB,EACtB,eAAe,EACf,YAAY,EACZ,WAAW,EACX,WAAW,EACX,aAAa,EACb,aAAa,EACb,iBAAiB,EACjB,QAAQ,EACR,mBAAmB,EACnB,oBAAoB,EACpB,cAAc,GACf,MAAM,0BAA0B,CAAC;AAClC,OAAO,EACL,KAAK,EACL,aAAa,EACb,iBAAiB,EACjB,YAAY,GACb,MAAM,0BAA0B,CAAC"}

package/dist/index.js

@@ -5,7 +5,9 @@
  * (`@earendil-works/pi-ai`, `@earendil-works/pi-agent-core`).
  *
  * Emits OTel GenAI semantic-convention spans for chat completions
- * (`chat ${provider}`) and tool execution (`execute_tool ${tool_name}`).
+ * (`chat ${model}`), tool execution (`execute_tool ${tool_name}`), and —
+ * optionally — agent runs (`invoke_agent ${agent_name}`), plus the GenAI
+ * client metrics when a meter is provided.
  *
  * @example
  * ```ts
@@ -21,10 +23,12 @@
 export { instrumentStream, } from "./instrument-stream.js";
 export { instrumentAgent, } from "./instrument-agent.js";
 // Attribute builders — exposed for callers that want to compose their own spans
-export { chatRequestAttributes, chatResponseAttributes, executeToolAttributes, executeToolResultAttribute, } from "./attributes.js";
+export { chatRequestAttributes, chatResponseAttributes, executeToolAttributes, executeToolResultAttribute, invokeAgentAttributes, serverAttributes, } from "./attributes.js";
+// Metric instruments — exposed for callers that record their own measurements
+export { genAiMetrics } from "./metrics.js";
 // Converters — exposed for telemetry replay (rebuilding pi-ai message arrays
 // from stored span attributes) and downstream consumers that want the raw
 // semconv shapes.
-export { assistantToOutputMessages, inputMessagesToMessages, messagesToInputMessages, systemPromptToInstructions, } from "./convert.js";
+export { assistantToOutputMessages, inputMessagesToMessages, messagesToInputMessages, semconvFinishReason, systemPromptToInstructions, } from "./convert.js";
 export { GenAi, GenAiSpanName, IntrospectionAttr, toAttributes, } from "@introspection-sdk/types";
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,kBAAkB;AAClB,OAAO,EACL,gBAAgB,GAEjB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EACL,eAAe,GAGhB,MAAM,uBAAuB,CAAC;AAE/B,gFAAgF;AAChF,OAAO,EACL,qBAAqB,EACrB,sBAAsB,EACtB,qBAAqB,EACrB,0BAA0B,GAE3B,MAAM,iBAAiB,CAAC;AAEzB,6EAA6E;AAC7E,0EAA0E;AAC1E,kBAAkB;AAClB,OAAO,EACL,yBAAyB,EACzB,uBAAuB,EACvB,uBAAuB,EACvB,0BAA0B,GAE3B,MAAM,cAAc,CAAC;AAiBtB,OAAO,EACL,KAAK,EACL,aAAa,EACb,iBAAiB,EACjB,YAAY,GACb,MAAM,0BAA0B,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,kBAAkB;AAClB,OAAO,EACL,gBAAgB,GAEjB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EACL,eAAe,GAGhB,MAAM,uBAAuB,CAAC;AAE/B,gFAAgF;AAChF,OAAO,EACL,qBAAqB,EACrB,sBAAsB,EACtB,qBAAqB,EACrB,0BAA0B,EAC1B,qBAAqB,EACrB,gBAAgB,GAEjB,MAAM,iBAAiB,CAAC;AAEzB,8EAA8E;AAC9E,OAAO,EAAE,YAAY,EAAqB,MAAM,cAAc,CAAC;AAE/D,6EAA6E;AAC7E,0EAA0E;AAC1E,kBAAkB;AAClB,OAAO,EACL,yBAAyB,EACzB,uBAAuB,EACvB,uBAAuB,EACvB,mBAAmB,EACnB,0BAA0B,GAE3B,MAAM,cAAc,CAAC;AAiBtB,OAAO,EACL,KAAK,EACL,aAAa,EACb,iBAAiB,EACjB,YAAY,GACb,MAAM,0BAA0B,CAAC"}

package/dist/instrument-agent.d.ts

@@ -1,8 +1,8 @@
 /**
  * Subscribe to a pi-agent {@link Agent} to emit `execute_tool` spans for every
- * tool call the loop runs.
+ * tool call the loop runs, and (optionally) one `invoke_agent` span per run.
  */
-import { type Attributes, type Context as OtelContext, type Tracer } from "@opentelemetry/api";
+import { type Attributes, type Context as OtelContext, type Meter, type Tracer } from "@opentelemetry/api";
 import type { Agent, AgentEvent } from "@earendil-works/pi-agent-core";
 import { type AgentMeta } from "./attributes.js";
 export interface InstrumentAgentOptions {
@@ -10,9 +10,31 @@ export interface InstrumentAgentOptions {
     tracer: Tracer;
     /** Required metadata stamped onto every execute_tool span. */
     meta: AgentMeta;
+    /**
+     * Optional meter. When set, the wrapper also records
+     * `gen_ai.execute_tool.duration` per tool call and (when `runSpans` is
+     * enabled) `gen_ai.invoke_agent.duration` per run.
+     */
+    meter?: Meter;
+    /**
+     * Emit one `invoke_agent {agent.name}` span per agent run
+     * (`agent_start` → `agent_end`), carrying conversation/agent identity
+     * and the final finish reason. Usage attributes stay on the chat spans
+     * only, so aggregations that sum a whole trace don't double-count.
+     *
+     * Off by default: hosts that already create their own turn/run spans
+     * (and parent chat spans onto them via `getParentContext`) would get
+     * duplicate run spans otherwise. When enabled, wire the chat spans under
+     * the run span with
+     * `instrumentStream(fn, { getParentContext: () => handle.getRunContext() })`;
+     * tool spans parent onto the run span automatically unless
+     * `getParentContext` is provided.
+     */
+    runSpans?: boolean;
     /**
      * Returns the parent OTel context for the next tool span. If undefined or
-     * returns null, `context.active()` is used at the time the start event fires.
+     * returns null, the active run span (when `runSpans` is enabled) or
+     * `context.active()` is used at the time the start event fires.
      */
     getParentContext?: () => OtelContext | null | undefined;
     /**
@@ -26,13 +48,20 @@ export interface InstrumentAgentOptions {
     spanName?: (toolName: string) => string;
 }
 export interface AgentInstrumentation {
-    /** Stop subscribing and finalize any tool spans still open. */
+    /** Stop subscribing and finalize any spans still open. */
     stop: () => void;
+    /**
+     * OTel context of the active `invoke_agent` span, when `runSpans` is
+     * enabled and a run is in flight. Pass to `instrumentStream`'s
+     * `getParentContext` so chat spans nest under the run span.
+     */
+    getRunContext: () => OtelContext | undefined;
 }
 /**
  * Subscribe to {@link Agent.subscribe} and emit one `execute_tool ${name}`
- * span per tool call. Returns a handle whose `stop()` unsubscribes and
- * finalizes any still-open spans.
+ * span per tool call (plus one `invoke_agent` span per run when enabled).
+ * Returns a handle whose `stop()` unsubscribes and finalizes any still-open
+ * spans.
  *
  * Tool call IDs are assumed unique per agent run; concurrent tool execution
  * (`ToolExecutionMode = "parallel"`) is supported because each id keys its