@xandout/libra-harness 0.1.8

package/dist/extras/extensions/memory/index.d.ts

@@ -0,0 +1,5 @@
+export { default as createMemoryExtension } from './extension.js';
+export { createLlmExtractor } from './llm-extractor.js';
+export type { LlmExtractorConfig } from './llm-extractor.js';
+export type { Memory, MemoryInput, MemoryPatch, MemoryQuery, MemoryStore, ExtractorInput, ExtractedMemory, MemoryExtractor, RetrievalInput, MemoryRetriever, MemoryExtensionConfig, } from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/extras/extensions/memory/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/extras/extensions/memory/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,IAAI,qBAAqB,EAAE,MAAM,gBAAgB,CAAC;AAClE,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AACxD,YAAY,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAC7D,YAAY,EACV,MAAM,EACN,WAAW,EACX,WAAW,EACX,WAAW,EACX,WAAW,EACX,cAAc,EACd,eAAe,EACf,eAAe,EACf,cAAc,EACd,eAAe,EACf,qBAAqB,GACtB,MAAM,YAAY,CAAC"}

package/dist/extras/extensions/memory/index.js

@@ -0,0 +1,3 @@
+export { default as createMemoryExtension } from './extension.js';
+export { createLlmExtractor } from './llm-extractor.js';
+//# sourceMappingURL=index.js.map

package/dist/extras/extensions/memory/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/extras/extensions/memory/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,IAAI,qBAAqB,EAAE,MAAM,gBAAgB,CAAC;AAClE,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/extras/extensions/memory/llm-extractor.d.ts

@@ -0,0 +1,42 @@
+import type { Model } from '../../../model.js';
+import type { MemoryExtractor } from './types.js';
+/**
+ * Configuration for the LLM-based memory extractor.
+ */
+export interface LlmExtractorConfig {
+    /**
+     * System prompt for the extraction call. Override to customize what
+     * the extractor considers memorable.
+     */
+    systemPrompt?: string;
+    /**
+     * Max tokens for the extraction response. Default: 2000.
+     * Keep this modest — extraction output is a JSON array, not prose.
+     */
+    maxTokens?: number;
+    /**
+     * Temperature for the extraction call. Default: 0 (deterministic).
+     */
+    temperature?: number;
+}
+/**
+ * Create an LLM-based memory extractor.
+ *
+ * This is the recommended extractor. It makes a single LLM call per turn
+ * (in `afterTurn`) with a focused prompt that asks the model to decide
+ * what to create, update, or delete from the conversation.
+ *
+ * It does not need to be a full `Agent` — a direct model call with
+ * structured output is sufficient and far cheaper.
+ *
+ * The extractor is resilient to malformed output: if the model returns
+ * invalid JSON, the extraction is treated as empty (nothing persisted).
+ *
+ * @example
+ * ```typescript
+ * const extractor = createLlmExtractor(model);
+ * const memoryExt = createMemoryExtension({ store, extractor });
+ * ```
+ */
+export declare function createLlmExtractor(model: Model, config?: LlmExtractorConfig): MemoryExtractor;
+//# sourceMappingURL=llm-extractor.d.ts.map

package/dist/extras/extensions/memory/llm-extractor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"llm-extractor.d.ts","sourceRoot":"","sources":["../../../../src/extras/extensions/memory/llm-extractor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAE/C,OAAO,KAAK,EAAE,eAAe,EAAmC,MAAM,YAAY,CAAC;AAEnF;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC;;;OAGG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,KAAK,EACZ,MAAM,CAAC,EAAE,kBAAkB,GAC1B,eAAe,CAuEjB"}

package/dist/extras/extensions/memory/llm-extractor.js

@@ -0,0 +1,89 @@
+import { messageContentToText } from '../../../types.js';
+/**
+ * Create an LLM-based memory extractor.
+ *
+ * This is the recommended extractor. It makes a single LLM call per turn
+ * (in `afterTurn`) with a focused prompt that asks the model to decide
+ * what to create, update, or delete from the conversation.
+ *
+ * It does not need to be a full `Agent` — a direct model call with
+ * structured output is sufficient and far cheaper.
+ *
+ * The extractor is resilient to malformed output: if the model returns
+ * invalid JSON, the extraction is treated as empty (nothing persisted).
+ *
+ * @example
+ * ```typescript
+ * const extractor = createLlmExtractor(model);
+ * const memoryExt = createMemoryExtension({ store, extractor });
+ * ```
+ */
+export function createLlmExtractor(model, config) {
+    const systemPrompt = config?.systemPrompt ??
+        'You are a memory extraction system. Analyze conversations and decide what memories to create, update, or delete. Return only a JSON array.';
+    const maxTokens = config?.maxTokens ?? 2000;
+    const temperature = config?.temperature ?? 0;
+    return {
+        async extract(input) {
+            const conversationText = input.messages
+                .filter((m) => m.role !== 'system')
+                .map((m) => {
+                if (m.role === 'assistant' && m.toolCalls?.length) {
+                    return `[assistant] ${messageContentToText(m.content)} (requested tools: ${m.toolCalls.map((t) => t.name).join(', ')})`;
+                }
+                return `[${m.role}] ${messageContentToText(m.content)}`;
+            })
+                .join('\n');
+            const existingText = input.existingMemories.length > 0
+                ? input.existingMemories
+                    .map((m) => `ID: ${m.id} | ${m.content}`)
+                    .join('\n')
+                : '(none)';
+            const prompt = `Analyze the following conversation and decide what memories to create, update, or delete.
+
+Existing memories for this session:
+${existingText}
+
+Conversation:
+${conversationText}
+
+Return a JSON array of operations. Each operation has:
+- "action": "create" | "update" | "delete"
+- "content": the memory text (for create/update)
+- "targetId": existing memory ID (required for update/delete)
+- "metadata": optional object
+
+Guidelines:
+- Memories should be concise, self-contained facts (1-3 sentences).
+- Deduplicate: if a new memory overlaps with an existing one, update it.
+- Delete memories that are contradicted by the conversation.
+- If nothing is worth remembering, return an empty array [].
+
+Return only the JSON array, no other text.`;
+            let response;
+            try {
+                response = await model.generate({
+                    messages: [{ role: 'user', content: prompt }],
+                    systemPrompt,
+                    maxTokens,
+                    temperature,
+                });
+            }
+            catch {
+                // Model call failed — skip extraction.
+                return [];
+            }
+            try {
+                const parsed = JSON.parse(messageContentToText(response.message.content));
+                if (!Array.isArray(parsed))
+                    return [];
+                return parsed;
+            }
+            catch {
+                // Malformed JSON — skip extraction.
+                return [];
+            }
+        },
+    };
+}
+//# sourceMappingURL=llm-extractor.js.map

package/dist/extras/extensions/memory/llm-extractor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"llm-extractor.js","sourceRoot":"","sources":["../../../../src/extras/extensions/memory/llm-extractor.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAuBzD;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,UAAU,kBAAkB,CAChC,KAAY,EACZ,MAA2B;IAE3B,MAAM,YAAY,GAChB,MAAM,EAAE,YAAY;QACpB,4IAA4I,CAAC;IAC/I,MAAM,SAAS,GAAG,MAAM,EAAE,SAAS,IAAI,IAAI,CAAC;IAC5C,MAAM,WAAW,GAAG,MAAM,EAAE,WAAW,IAAI,CAAC,CAAC;IAE7C,OAAO;QACL,KAAK,CAAC,OAAO,CAAC,KAAqB;YACjC,MAAM,gBAAgB,GAAG,KAAK,CAAC,QAAQ;iBACpC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,QAAQ,CAAC;iBAClC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;gBACT,IAAI,CAAC,CAAC,IAAI,KAAK,WAAW,IAAI,CAAC,CAAC,SAAS,EAAE,MAAM,EAAE,CAAC;oBAClD,OAAO,eAAe,oBAAoB,CAAC,CAAC,CAAC,OAAO,CAAC,sBAAsB,CAAC,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC;gBAC1H,CAAC;gBACD,OAAO,IAAI,CAAC,CAAC,IAAI,KAAK,oBAAoB,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;YAC1D,CAAC,CAAC;iBACD,IAAI,CAAC,IAAI,CAAC,CAAC;YAEd,MAAM,YAAY,GAChB,KAAK,CAAC,gBAAgB,CAAC,MAAM,GAAG,CAAC;gBAC/B,CAAC,CAAC,KAAK,CAAC,gBAAgB;qBACnB,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,OAAO,EAAE,CAAC;qBACxC,IAAI,CAAC,IAAI,CAAC;gBACf,CAAC,CAAC,QAAQ,CAAC;YAEf,MAAM,MAAM,GAAG;;;EAGnB,YAAY;;;EAGZ,gBAAgB;;;;;;;;;;;;;;2CAcyB,CAAC;YAEtC,IAAI,QAAQ,CAAC;YACb,IAAI,CAAC;gBACH,QAAQ,GAAG,MAAM,KAAK,CAAC,QAAQ,CAAC;oBAC9B,QAAQ,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC;oBAC7C,YAAY;oBACZ,SAAS;oBACT,WAAW;iBACZ,CAAC,CAAC;YACL,CAAC;YAAC,MAAM,CAAC;gBACP,uCAAuC;gBACvC,OAAO,EAAE,CAAC;YACZ,CAAC;YAED,IAAI,CAAC;gBACH,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,oBAAoB,CAAC,QAAQ,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC;gBAC1E,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC;oBAAE,OAAO,EAAE,CAAC;gBACtC,OAAO,MAA2B,CAAC;YACrC,CAAC;YAAC,MAAM,CAAC;gBACP,oCAAoC;gBACpC,OAAO,EAAE,CAAC;YACZ,CAAC;QACH,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/extras/extensions/memory/types.d.ts

@@ -0,0 +1,142 @@
+import type { Message } from '../../../types.js';
+import type { AgentResponse } from '../../../context.js';
+/**
+ * A discrete piece of knowledge extracted from a conversation.
+ *
+ * Memories are natural language, not structured records. They should be
+ * concise (1-3 sentences) and self-contained.
+ */
+export interface Memory {
+    /** Unique identifier assigned by the store on creation. */
+    id: string;
+    /** Natural language text, 1-3 sentences, self-contained. */
+    content: string;
+    /** Session ID this memory belongs to. */
+    scope: string;
+    /** ISO timestamp — when the memory was first created. */
+    createdAt: string;
+    /** ISO timestamp — when the memory was last updated. */
+    updatedAt: string;
+    /** Optional metadata: tags, source, confidence, category, etc. */
+    metadata?: Record<string, unknown>;
+}
+/** Input for creating a new memory. */
+export interface MemoryInput {
+    content: string;
+    scope: string;
+    metadata?: Record<string, unknown>;
+}
+/** Patch for updating an existing memory. */
+export interface MemoryPatch {
+    content?: string;
+    metadata?: Record<string, unknown>;
+}
+/** Query for searching memories. */
+export interface MemoryQuery {
+    /** Session ID to search within. */
+    scope: string;
+    /** Natural language search text (typically the user's message). */
+    text: string;
+    /** Maximum results to return. */
+    maxResults?: number;
+    /** Optional metadata filters (implementation-specific). */
+    filter?: Record<string, unknown>;
+}
+/**
+ * Abstract storage backend.
+ *
+ * The memory extension depends on this interface; the host provides a
+ * concrete implementation (vector DB, SQLite, Postgres, etc.).
+ *
+ * The search ranking algorithm is implementation-specific. A vector DB
+ * would use cosine similarity; a simple KV store might do keyword matching.
+ * The contract is: given a scope and text, return the most relevant
+ * memories, best first.
+ */
+export interface MemoryStore {
+    /** Create a new memory. Returns the stored memory with id/timestamps. */
+    save(input: MemoryInput): Promise<Memory>;
+    /** Get a single memory by ID. Returns null if not found. */
+    get(id: string): Promise<Memory | null>;
+    /** Search memories within a scope. Returns results ranked by relevance. */
+    search(query: MemoryQuery): Promise<Memory[]>;
+    /** Update a memory's content and/or metadata. */
+    update(id: string, patch: MemoryPatch): Promise<Memory>;
+    /** Delete a memory by ID. */
+    delete(id: string): Promise<void>;
+    /** List all memories for a scope (for extractor dedup context). */
+    listByScope(scope: string): Promise<Memory[]>;
+    /** Optional: prune memories according to a store-defined policy. */
+    prune?(scope: string): Promise<number>;
+}
+/** Input passed to the extractor. */
+export interface ExtractorInput {
+    /** Session ID. */
+    scope: string;
+    /** The full conversation messages from this turn. */
+    messages: Message[];
+    /** The agent's final response. */
+    response: AgentResponse;
+    /** Existing memories for this scope (for dedup/update/delete decisions). */
+    existingMemories: Memory[];
+}
+/**
+ * A single extraction operation — what the extractor decided to do with
+ * one piece of information from the conversation.
+ */
+export interface ExtractedMemory {
+    /** The memory text (for create) or new text (for update). */
+    content: string;
+    /** What to do with this extraction. */
+    action: 'create' | 'update' | 'delete';
+    /** Required for update/delete — the existing memory ID to modify. */
+    targetId?: string;
+    /** Optional metadata to attach or merge. */
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Decides what to remember from a completed turn.
+ *
+ * Called in the `afterTurn` hook. Receives the full conversation and
+ * existing memories so it can deduplicate, update, or delete as well as
+ * create. Returns a list of operations to apply to the store.
+ */
+export interface MemoryExtractor {
+    extract(input: ExtractorInput): Promise<ExtractedMemory[]>;
+}
+/** Input passed to the retriever. */
+export interface RetrievalInput {
+    /** Session ID. */
+    scope: string;
+    /** The user's message (search query). */
+    text: string;
+    /** The store to search against. */
+    store: MemoryStore;
+}
+/**
+ * Formats and filters search results before injection.
+ *
+ * Separated from the store so retrieval logic (formatting, truncation,
+ * relevance thresholds) can vary independently of storage.
+ */
+export interface MemoryRetriever {
+    retrieve(input: RetrievalInput): Promise<Memory[]>;
+}
+/**
+ * Configuration for the memory extension.
+ */
+export interface MemoryExtensionConfig {
+    /** Storage backend (required). */
+    store: MemoryStore;
+    /** Extraction strategy (required). */
+    extractor: MemoryExtractor;
+    /** Retrieval strategy (optional — defaults to pass-through to store.search). */
+    retriever?: MemoryRetriever;
+    /** Max memories to inject per turn (default: 10). */
+    maxRecall?: number;
+    /** Metadata key for session ID (default: 'sessionId'). */
+    scopeKey?: string;
+    /** Extension load priority (default: -95). */
+    priority?: number;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/extras/extensions/memory/types.d.ts.map

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

package/dist/extras/extensions/memory/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/extras/extensions/memory/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../src/extras/extensions/memory/types.ts"],"names":[],"mappings":""}

package/dist/extras/extensions/otel/extension.d.ts

@@ -0,0 +1,57 @@
+import type { Extension } from '../../../extension.js';
+import { type Tracer } from '@opentelemetry/api';
+/**
+ * Config for the OpenTelemetry extension.
+ *
+ * The extension codes against `@opentelemetry/api` only. The host is
+ * responsible for setting up an SDK and exporter (e.g.
+ * `@opentelemetry/sdk-node`) before creating the agent — the extension
+ * just acquires a tracer and creates spans.
+ */
+export interface OtelExtensionConfig {
+    /**
+     * Tracer to use. If omitted, acquires the global tracer registered
+     * with `@opentelemetry/api` under the given `tracerName` (default:
+     * `'libra'`). Most hosts register a global tracer provider and never
+     * need to pass this.
+     */
+    tracer?: Tracer;
+    /** Tracer name used with `trace.getTracer()`. Default: `'libra'`. */
+    tracerName?: string;
+    /**
+     * Service name set as an attribute on the root turn span. Useful for
+     * distinguishing multiple agents in the same process (e.g.
+     * `'slack-bot'`, `'research-agent'`). Default: not set.
+     */
+    serviceName?: string;
+    /**
+     * Whether to record tool call arguments as span attributes. Default:
+     * `false` — arguments may contain sensitive data. Enable only in
+     * trusted environments.
+     */
+    recordToolArgs?: boolean;
+    /**
+     * Max length for tool result content recorded as a span event.
+     * Default: 500. Set to 0 to disable result recording.
+     */
+    maxResultLength?: number;
+    /**
+     * Metadata keys to record as span attributes on the root `agent.turn`
+     * span. This is how turns are correlated to sessions, channels, users,
+     * etc. The extension reads `ctx.turn.metadata[key]` and sets
+     * `libra.turn.<key>` on the span.
+     *
+     * Nested keys are supported via dot notation — e.g. `'slack.channelId'`
+     * reads `metadata.slack.channelId` and records it as
+     * `libra.turn.slack.channelId`.
+     *
+     * Default: `['sessionId']` — records the session ID if present.
+     * The slack-bot overrides this to also record channel/thread/user info.
+     *
+     * Only string, number, and boolean values are recorded; objects and
+     * arrays are skipped (OTel attributes are primitives).
+     */
+    metadataKeys?: string[];
+}
+export default function createOtelExtension(config?: OtelExtensionConfig): Extension;
+//# sourceMappingURL=extension.d.ts.map

package/dist/extras/extensions/otel/extension.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"extension.d.ts","sourceRoot":"","sources":["../../../../src/extras/extensions/otel/extension.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAEvD,OAAO,EAAkC,KAAK,MAAM,EAAa,MAAM,oBAAoB,CAAC;AAE5F;;;;;;;GAOG;AACH,MAAM,WAAW,mBAAmB;IAClC;;;;;OAKG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,qEAAqE;IACrE,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;;;OAIG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;;OAIG;IACH,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB;;;OAGG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB;;;;;;;;;;;;;;;OAeG;IACH,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;CACzB;AAqED,MAAM,CAAC,OAAO,UAAU,mBAAmB,CACzC,MAAM,CAAC,EAAE,mBAAmB,GAC3B,SAAS,CAsNX"}

package/dist/extras/extensions/otel/extension.js

@@ -0,0 +1,253 @@
+import { messageContentToText } from '../../../types.js';
+import { trace, context, SpanStatusCode } from '@opentelemetry/api';
+/**
+ * OpenTelemetry observability extension.
+ *
+ * Creates a span hierarchy that mirrors the agent turn lifecycle:
+ *
+ * ```
+ * agent.turn (root span)
+ *   ├── llm.request (per LLM call)
+ *   ├── llm.request
+ *   │   ├── tool.<name> (per tool call)
+ *   │   └── tool.<name>
+ *   └── llm.request
+ * ```
+ *
+ * Spans are created using `@opentelemetry/api` — the host must register
+ * a tracer provider (e.g. via `@opentelemetry/sdk-node`) for spans to
+ * be collected and exported. If no provider is registered, the
+ * extension is a no-op (the API returns no-op spans).
+ *
+ * ## Span attributes
+ *
+ * **agent.turn** (root):
+ * - `libra.turn.finish_reason` — stop, halted, max_iterations, error
+ * - `libra.turn.iterations` — number of LLM iterations
+ * - `libra.turn.tool_calls` — total tool calls made
+ * - `libra.turn.message_length` — input message length
+ * - `libra.turn.duration_ms` — total turn duration
+ * - `libra.service` — service name (if configured)
+ * - `libra.turn.<key>` — one per configured `metadataKeys` (default:
+ *   `libra.turn.sessionId`). Used to correlate turns to sessions,
+ *   channels, users, etc. Supports dot notation (e.g.
+ *   `slack.channelId` → `libra.turn.slack.channelId`).
+ *
+ * **llm.request**:
+ * - `libra.llm.message_count` — messages sent to the model
+ * - `libra.llm.tool_count` — tools available to the model
+ * - `libra.llm.has_tool_calls` — whether the response requested tools
+ * - `libra.llm.prompt_tokens` — prompt tokens (if reported by provider)
+ * - `libra.llm.completion_tokens` — completion tokens (if reported)
+ * - `libra.llm.cached_prompt_tokens` — cached prompt tokens (if reported)
+ * - `libra.llm.reasoning_tokens` — reasoning tokens (if reported)
+ *
+ * **tool.\<name\>**:
+ * - `libra.tool.name` — tool name
+ * - `libra.tool.is_error` — whether the tool returned an error
+ * - `libra.tool.args` — tool arguments JSON (if `recordToolArgs` enabled)
+ *
+ * ## Priority
+ *
+ * Uses priority 200 (higher than logger at 100) so spans start before
+ * other extensions mutate state — timing reflects raw lifecycle cost.
+ */
+/**
+ * Resolve a dot-notation path from a metadata object.
+ * e.g. 'slack.channelId' → metadata.slack.channelId
+ * Returns undefined if any segment is missing or not an object.
+ */
+function resolveMetaPath(meta, path) {
+    const parts = path.split('.');
+    let current = meta;
+    for (const part of parts) {
+        if (current === null || typeof current !== 'object')
+            return undefined;
+        current = current[part];
+    }
+    return current;
+}
+export default function createOtelExtension(config) {
+    const tracer = config?.tracer ?? trace.getTracer(config?.tracerName ?? 'libra');
+    const serviceName = config?.serviceName;
+    const recordToolArgs = config?.recordToolArgs ?? false;
+    const maxResultLength = config?.maxResultLength ?? 500;
+    const metadataKeys = config?.metadataKeys ?? ['sessionId'];
+    // Per-turn span state, keyed by the turn object identity. This avoids
+    // relying on turn.metadata (which other extensions may clear or mutate)
+    // and naturally supports concurrent turns.
+    const turnSpans = new WeakMap();
+    // The active LLM span for the current iteration. Stored in a per-turn
+    // WeakMap so tool spans are created as children of the right LLM span.
+    const llmSpans = new WeakMap();
+    // Timing for stages that don't have a natural span (beforeTurn → afterTurn
+    // is the root span, but we also record per-stage durations as events).
+    const stageTimings = new WeakMap();
+    function getTiming(turn, stage) {
+        return stageTimings.get(turn)?.get(stage);
+    }
+    function setTiming(turn, stage, time) {
+        let map = stageTimings.get(turn);
+        if (!map) {
+            map = new Map();
+            stageTimings.set(turn, map);
+        }
+        map.set(stage, time);
+    }
+    return {
+        name: 'otel',
+        priority: 200,
+        install(agent) {
+            // ── beforeTurn: start root span ──────────────────────────────
+            agent.hook('beforeTurn', 'otel', async (ctx) => {
+                const span = tracer.startSpan('agent.turn');
+                const turnObj = ctx.turn;
+                turnSpans.set(turnObj, span);
+                if (serviceName) {
+                    span.setAttribute('libra.service', serviceName);
+                }
+                span.setAttribute('libra.turn.message_length', messageContentToText(ctx.turn.request.message).length);
+                // Record metadata keys as span attributes for session/channel
+                // correlation. Supports dot notation for nested keys (e.g.
+                // 'slack.channelId' → metadata.slack.channelId).
+                const meta = ctx.turn.metadata;
+                for (const key of metadataKeys) {
+                    const value = resolveMetaPath(meta, key);
+                    if (value !== undefined && (typeof value === 'string' || typeof value === 'number' || typeof value === 'boolean')) {
+                        span.setAttribute(`libra.turn.${key}`, value);
+                    }
+                }
+                setTiming(turnObj, 'beforeTurn', performance.now());
+                // Set the span as active so child spans (LLM, tools) are
+                // parented to it automatically via context.
+                context.active();
+            });
+            // ── beforeContext: record timing ─────────────────────────────
+            agent.hook('beforeContext', 'otel', async (ctx) => {
+                setTiming(ctx.turn, 'beforeContext', performance.now());
+            });
+            // ── beforeLLM: start LLM child span ──────────────────────────
+            agent.hook('beforeLLM', 'otel', async (ctx) => {
+                const turnObj = ctx.turn;
+                const rootSpan = turnSpans.get(turnObj);
+                if (!rootSpan)
+                    return;
+                // Start the LLM span as a child of the root span.
+                const llmSpan = tracer.startSpan('llm.request', undefined, trace.setSpan(context.active(), rootSpan));
+                llmSpans.set(turnObj, llmSpan);
+                if (ctx.modelRequest) {
+                    llmSpan.setAttribute('libra.llm.message_count', ctx.modelRequest.messages.length);
+                    llmSpan.setAttribute('libra.llm.tool_count', ctx.modelRequest.tools?.length ?? 0);
+                }
+            });
+            // ── afterLLM: end LLM span, record usage ─────────────────────
+            agent.hook('afterLLM', 'otel', async (ctx) => {
+                const turnObj = ctx.turn;
+                const llmSpan = llmSpans.get(turnObj);
+                if (!llmSpan)
+                    return;
+                const resp = ctx.modelResponse;
+                if (resp) {
+                    const toolCalls = resp.message.toolCalls;
+                    llmSpan.setAttribute('libra.llm.has_tool_calls', !!toolCalls?.length);
+                    if (resp.usage) {
+                        llmSpan.setAttribute('libra.llm.prompt_tokens', resp.usage.promptTokens);
+                        llmSpan.setAttribute('libra.llm.completion_tokens', resp.usage.completionTokens);
+                        if (resp.usage.cachedPromptTokens) {
+                            llmSpan.setAttribute('libra.llm.cached_prompt_tokens', resp.usage.cachedPromptTokens);
+                        }
+                        if (resp.usage.reasoningTokens) {
+                            llmSpan.setAttribute('libra.llm.reasoning_tokens', resp.usage.reasoningTokens);
+                        }
+                    }
+                    if (resp.finishReason) {
+                        llmSpan.setAttribute('libra.llm.finish_reason', resp.finishReason);
+                    }
+                }
+                llmSpan.end();
+                llmSpans.delete(turnObj);
+            });
+            // ── beforeTool: start tool child span ────────────────────────
+            agent.hook('beforeTool', 'otel', async (ctx) => {
+                const turnObj = ctx.turn;
+                const toolName = ctx.toolCall?.name ?? 'unknown';
+                const parentSpan = llmSpans.get(turnObj) ?? turnSpans.get(turnObj);
+                if (!parentSpan)
+                    return;
+                const toolSpan = tracer.startSpan(`tool.${toolName}`, undefined, trace.setSpan(context.active(), parentSpan));
+                // Stash the tool span on the turn's metadata so afterTool can
+                // find it. Use a unique key per tool call id to handle batches.
+                if (ctx.toolCall) {
+                    const key = `_otel_tool_span_${ctx.toolCall.id}`;
+                    ctx.turn.metadata[key] = toolSpan;
+                }
+                toolSpan.setAttribute('libra.tool.name', toolName);
+                if (recordToolArgs && ctx.toolCall) {
+                    try {
+                        toolSpan.setAttribute('libra.tool.args', ctx.toolCall.arguments);
+                    }
+                    catch {
+                        // Args may not be serializable — skip.
+                    }
+                }
+            });
+            // ── afterTool: end tool span, record result ──────────────────
+            agent.hook('afterTool', 'otel', async (ctx) => {
+                if (!ctx.toolCall)
+                    return;
+                const key = `_otel_tool_span_${ctx.toolCall.id}`;
+                const toolSpan = ctx.turn.metadata[key];
+                if (!toolSpan)
+                    return;
+                if (ctx.toolResult) {
+                    const isError = !!ctx.toolResult.isError;
+                    toolSpan.setAttribute('libra.tool.is_error', isError);
+                    if (maxResultLength > 0 && ctx.toolResult.content) {
+                        const content = ctx.toolResult.content;
+                        const truncated = content.length > maxResultLength
+                            ? content.slice(0, maxResultLength) + '…'
+                            : content;
+                        toolSpan.addEvent('tool.result', { 'libra.tool.result': truncated });
+                    }
+                    if (isError) {
+                        toolSpan.setStatus({ code: SpanStatusCode.ERROR });
+                    }
+                }
+                toolSpan.end();
+                delete ctx.turn.metadata[key];
+            });
+            // ── onError: record exception on root span ───────────────────
+            agent.hook('onError', 'otel', async (ctx) => {
+                const rootSpan = turnSpans.get(ctx.turn);
+                if (!rootSpan)
+                    return;
+                const err = ctx.error;
+                const message = err instanceof Error ? err.message : String(err);
+                rootSpan.recordException(err instanceof Error ? err : new Error(message));
+                rootSpan.setStatus({ code: SpanStatusCode.ERROR, message });
+            });
+            // ── afterTurn: end root span with final attributes ────────────
+            agent.hook('afterTurn', 'otel', async (ctx) => {
+                const turnObj = ctx.turn;
+                const rootSpan = turnSpans.get(turnObj);
+                if (!rootSpan)
+                    return;
+                const resp = ctx.turn.response;
+                if (resp) {
+                    rootSpan.setAttribute('libra.turn.finish_reason', resp.finishReason);
+                    rootSpan.setAttribute('libra.turn.iterations', resp.iterations);
+                    rootSpan.setAttribute('libra.turn.tool_calls', resp.toolCalls?.length ?? 0);
+                }
+                // Record total turn duration as an attribute.
+                const startTime = getTiming(turnObj, 'beforeTurn');
+                if (startTime) {
+                    const durationMs = performance.now() - startTime;
+                    rootSpan.setAttribute('libra.turn.duration_ms', Math.round(durationMs));
+                }
+                rootSpan.end();
+                turnSpans.delete(turnObj);
+            });
+        },
+    };
+}
+//# sourceMappingURL=extension.js.map

package/dist/extras/extensions/otel/extension.js.map

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