@digilogiclabs/platform-core 1.13.0 → 1.15.0

package/dist/agents.d.mts

@@ -0,0 +1,2 @@
+export { F as AgentBudget, p as AgentCumulativeUsage, r as AgentIterationCallback, q as AgentIterationEvent, t as AgentLoopOptions, u as AgentLoopResult, s as AgentStopReason, n as AgentTool, o as AgentToolResult, x as AgentTracer, w as AgentTracerOptions, E as AgentUsageRecordParams, G as AgentUsageTracker, z as AgentUsageTrackerOptions, D as DEFAULT_AGENT_LOOP_OPTIONS, T as ToolExecutor, J as TracedAIOptions, y as createAgentTracer, H as createAgentUsageTracker, K as createTracedAI, v as runAgentLoop } from './agents-Cd2eEX5M.mjs';
+import './IAI-D8wA_i8N.mjs';

package/dist/agents.d.ts

@@ -0,0 +1,2 @@
+export { F as AgentBudget, p as AgentCumulativeUsage, r as AgentIterationCallback, q as AgentIterationEvent, t as AgentLoopOptions, u as AgentLoopResult, s as AgentStopReason, n as AgentTool, o as AgentToolResult, x as AgentTracer, w as AgentTracerOptions, E as AgentUsageRecordParams, G as AgentUsageTracker, z as AgentUsageTrackerOptions, D as DEFAULT_AGENT_LOOP_OPTIONS, T as ToolExecutor, J as TracedAIOptions, y as createAgentTracer, H as createAgentUsageTracker, K as createTracedAI, v as runAgentLoop } from './agents-CntmA45w.js';
+import './IAI-D8wA_i8N.js';

package/dist/agents.js

@@ -0,0 +1,479 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/agents.ts
+var agents_exports = {};
+__export(agents_exports, {
+  DEFAULT_AGENT_LOOP_OPTIONS: () => DEFAULT_AGENT_LOOP_OPTIONS,
+  createAgentTracer: () => createAgentTracer,
+  createAgentUsageTracker: () => createAgentUsageTracker,
+  createTracedAI: () => createTracedAI,
+  runAgentLoop: () => runAgentLoop
+});
+module.exports = __toCommonJS(agents_exports);
+
+// src/interfaces/ILogger.ts
+var NoopLogger = class {
+  debug() {
+  }
+  info() {
+  }
+  warn() {
+  }
+  error() {
+  }
+  child() {
+    return this;
+  }
+};
+
+// src/agent/agent-loop.ts
+var DEFAULT_AGENT_LOOP_OPTIONS = {
+  maxIterations: 10,
+  maxTokens: Infinity,
+  maxCostUsd: Infinity,
+  cacheTtlSeconds: 300,
+  cacheKeyPrefix: "agent:tool:"
+};
+function mapFinishReason(reason) {
+  switch (reason) {
+    case "stop":
+      return "stop";
+    case "length":
+      return "length";
+    case "content_filter":
+      return "content_filter";
+    case "tool_calls":
+      return "stop";
+    // shouldn't reach here in normal flow
+    case "error":
+    default:
+      return "error";
+  }
+}
+async function executeToolCall(toolCall, executorMap, cache, cacheKeyPrefix, cacheTtlSeconds) {
+  const start = Date.now();
+  const executor = executorMap.get(toolCall.function.name);
+  if (!executor) {
+    return {
+      toolCall,
+      result: `Error: Unknown tool "${toolCall.function.name}"`,
+      success: false,
+      error: `Unknown tool: ${toolCall.function.name}`,
+      durationMs: Date.now() - start,
+      cached: false
+    };
+  }
+  if (cache) {
+    const cacheKey = cacheKeyPrefix + toolCall.function.name + ":" + toolCall.function.arguments;
+    try {
+      const cached = await cache.get(cacheKey);
+      if (cached !== null) {
+        return {
+          toolCall,
+          result: cached,
+          success: true,
+          durationMs: Date.now() - start,
+          cached: true
+        };
+      }
+    } catch {
+    }
+  }
+  try {
+    const parsed = JSON.parse(toolCall.function.arguments);
+    const result = await executor.execute(parsed, toolCall);
+    if (cache) {
+      const cacheKey = cacheKeyPrefix + toolCall.function.name + ":" + toolCall.function.arguments;
+      await cache.set(cacheKey, result, cacheTtlSeconds).catch(() => {
+      });
+    }
+    return {
+      toolCall,
+      result,
+      success: true,
+      durationMs: Date.now() - start,
+      cached: false
+    };
+  } catch (err) {
+    const errorMsg = err instanceof Error ? err.message : String(err);
+    return {
+      toolCall,
+      result: `Error: ${errorMsg}`,
+      success: false,
+      error: errorMsg,
+      durationMs: Date.now() - start,
+      cached: false
+    };
+  }
+}
+async function runAgentLoop(options) {
+  const opts = { ...DEFAULT_AGENT_LOOP_OPTIONS, ...options };
+  const logger = opts.logger ?? new NoopLogger();
+  const toolDefs = opts.tools.map((t) => t.definition);
+  const executorMap = /* @__PURE__ */ new Map();
+  for (const tool of opts.tools) {
+    executorMap.set(tool.definition.function.name, tool);
+  }
+  const messages = [...opts.messages];
+  const iterations = [];
+  const cumulative = {
+    promptTokens: 0,
+    completionTokens: 0,
+    totalTokens: 0,
+    estimatedCostUsd: 0,
+    iterations: 0,
+    toolCallCount: 0
+  };
+  let lastResponse;
+  let stopReason = "stop";
+  for (let i = 1; i <= opts.maxIterations; i++) {
+    if (opts.signal?.aborted) {
+      stopReason = "aborted";
+      break;
+    }
+    if (cumulative.totalTokens >= opts.maxTokens) {
+      stopReason = "max_tokens";
+      break;
+    }
+    if (cumulative.estimatedCostUsd >= opts.maxCostUsd) {
+      stopReason = "max_cost";
+      break;
+    }
+    logger.debug("Agent loop iteration", { iteration: i });
+    const chatRequest = {
+      ...opts.chatRequestOverrides,
+      messages,
+      tools: toolDefs.length > 0 ? toolDefs : void 0
+    };
+    const response = await opts.ai.chat(chatRequest);
+    lastResponse = response;
+    cumulative.promptTokens += response.usage.promptTokens;
+    cumulative.completionTokens += response.usage.completionTokens;
+    cumulative.totalTokens += response.usage.totalTokens;
+    cumulative.estimatedCostUsd += response.usage.estimatedCostUsd;
+    cumulative.iterations = i;
+    const assistantMessage = response.choices[0]?.message;
+    if (!assistantMessage) {
+      stopReason = "error";
+      break;
+    }
+    messages.push(assistantMessage);
+    if (response.finishReason !== "tool_calls") {
+      stopReason = mapFinishReason(response.finishReason);
+      const event2 = {
+        iteration: i,
+        response,
+        toolCalls: [],
+        cumulativeUsage: { ...cumulative },
+        messages: [...messages]
+      };
+      iterations.push(event2);
+      await opts.onIteration?.(event2);
+      break;
+    }
+    const toolCalls = assistantMessage.toolCalls ?? [];
+    cumulative.toolCallCount += toolCalls.length;
+    const toolResults = await Promise.all(
+      toolCalls.map(
+        (tc) => executeToolCall(
+          tc,
+          executorMap,
+          opts.cache,
+          opts.cacheKeyPrefix,
+          opts.cacheTtlSeconds
+        )
+      )
+    );
+    for (const tr of toolResults) {
+      messages.push({
+        role: "tool",
+        content: tr.result,
+        toolCallId: tr.toolCall.id
+      });
+    }
+    const event = {
+      iteration: i,
+      response,
+      toolCalls: toolResults,
+      cumulativeUsage: { ...cumulative },
+      messages: [...messages]
+    };
+    iterations.push(event);
+    const callbackResult = await opts.onIteration?.(event);
+    if (callbackResult === false) {
+      stopReason = "callback_abort";
+      break;
+    }
+    if (i === opts.maxIterations) {
+      stopReason = "max_iterations";
+    }
+  }
+  return {
+    response: lastResponse,
+    messages,
+    stopReason,
+    iterations,
+    usage: cumulative
+  };
+}
+
+// src/agent/agent-tracer.ts
+function createAgentTracer(options) {
+  const { tracing, agentId } = options;
+  return {
+    async traceLoop(fn) {
+      return tracing.withSpanAsync(
+        "agent.loop",
+        async (span) => {
+          span.setAttribute("agent.id", agentId);
+          return fn(span);
+        },
+        { kind: "internal" }
+      );
+    },
+    async traceIteration(iteration, fn) {
+      return tracing.withSpanAsync(
+        "agent.iteration",
+        async (span) => {
+          span.setAttributes({
+            "agent.id": agentId,
+            "agent.iteration": iteration
+          });
+          return fn(span);
+        },
+        { kind: "internal" }
+      );
+    },
+    async traceToolCall(toolName, fn) {
+      return tracing.withSpanAsync(
+        `agent.tool.${toolName}`,
+        async (span) => {
+          span.setAttributes({
+            "agent.id": agentId,
+            "agent.tool.name": toolName
+          });
+          const result = await fn(span);
+          span.setAttributes({
+            "agent.tool.duration_ms": result.durationMs,
+            "agent.tool.success": result.success,
+            "agent.tool.cached": result.cached
+          });
+          if (result.error) {
+            span.setAttribute("agent.tool.error", result.error);
+          }
+          return result;
+        },
+        { kind: "internal" }
+      );
+    },
+    traceDecision(span, attrs) {
+      span.setAttributes({
+        "agent.decision.finish_reason": attrs.finishReason,
+        "agent.decision.tool_count": attrs.toolCallCount,
+        "agent.decision.total_tokens": attrs.cumulativeUsage.totalTokens,
+        "agent.decision.cost_usd": attrs.cumulativeUsage.estimatedCostUsd,
+        "agent.decision.iterations": attrs.cumulativeUsage.iterations
+      });
+      span.addEvent("agent.decision", {
+        finish_reason: attrs.finishReason,
+        tool_count: attrs.toolCallCount
+      });
+    }
+  };
+}
+
+// src/agent/agent-usage.ts
+function createAgentUsageTracker(options) {
+  const { usage, agentId, tenantId, userId } = options;
+  return {
+    async recordIteration(params) {
+      return usage.record({
+        tenantId,
+        userId,
+        category: params.category ?? "chat",
+        provider: params.provider,
+        model: params.model,
+        inputTokens: params.usage.promptTokens,
+        outputTokens: params.usage.completionTokens,
+        totalTokens: params.usage.totalTokens,
+        costUsd: params.usage.estimatedCostUsd,
+        latencyMs: params.latencyMs ?? 0,
+        success: params.success ?? true,
+        error: params.error,
+        metadata: { agentId }
+      });
+    },
+    createBudgetCallback(budget) {
+      return async (event) => {
+        const response = event.response;
+        await usage.record({
+          tenantId,
+          userId,
+          category: "chat",
+          provider: response.provider,
+          model: response.model,
+          inputTokens: response.usage.promptTokens,
+          outputTokens: response.usage.completionTokens,
+          totalTokens: response.usage.totalTokens,
+          costUsd: response.usage.estimatedCostUsd,
+          latencyMs: 0,
+          success: true,
+          metadata: { agentId, iteration: event.iteration }
+        });
+        if (budget) {
+          if (budget.maxCostUsd !== void 0 && event.cumulativeUsage.estimatedCostUsd >= budget.maxCostUsd) {
+            return false;
+          }
+          if (budget.maxTokens !== void 0 && event.cumulativeUsage.totalTokens >= budget.maxTokens) {
+            return false;
+          }
+        }
+      };
+    }
+  };
+}
+
+// src/agent/traced-ai.ts
+function createTracedAI(options) {
+  const { ai, tracing } = options;
+  return {
+    async chat(request) {
+      return tracing.withSpanAsync(
+        "ai.chat",
+        async (span) => {
+          const start = Date.now();
+          if (request.model) {
+            span.setAttribute("ai.model", request.model);
+          }
+          try {
+            const response = await ai.chat(request);
+            span.setAttributes({
+              "ai.provider": response.provider,
+              "ai.model": response.model,
+              "ai.input_tokens": response.usage.promptTokens,
+              "ai.output_tokens": response.usage.completionTokens,
+              "ai.total_tokens": response.usage.totalTokens,
+              "ai.cost_usd": response.usage.estimatedCostUsd,
+              "ai.finish_reason": response.finishReason,
+              "ai.latency_ms": Date.now() - start
+            });
+            span.setStatus({ code: "ok" });
+            return response;
+          } catch (err) {
+            span.setAttributes({
+              "ai.latency_ms": Date.now() - start
+            });
+            if (err instanceof Error) {
+              span.recordException(err);
+            }
+            span.setStatus({
+              code: "error",
+              message: err instanceof Error ? err.message : String(err)
+            });
+            throw err;
+          }
+        },
+        { kind: "client" }
+      );
+    },
+    async *chatStream(request) {
+      yield* ai.chatStream(request);
+    },
+    async chatWithCallback(request, callback) {
+      return tracing.withSpanAsync(
+        "ai.chatWithCallback",
+        async (span) => {
+          const start = Date.now();
+          if (request.model) {
+            span.setAttribute("ai.model", request.model);
+          }
+          try {
+            const response = await ai.chatWithCallback(request, callback);
+            span.setAttributes({
+              "ai.provider": response.provider,
+              "ai.model": response.model,
+              "ai.input_tokens": response.usage.promptTokens,
+              "ai.output_tokens": response.usage.completionTokens,
+              "ai.total_tokens": response.usage.totalTokens,
+              "ai.cost_usd": response.usage.estimatedCostUsd,
+              "ai.finish_reason": response.finishReason,
+              "ai.latency_ms": Date.now() - start
+            });
+            span.setStatus({ code: "ok" });
+            return response;
+          } catch (err) {
+            span.setAttributes({
+              "ai.latency_ms": Date.now() - start
+            });
+            if (err instanceof Error) {
+              span.recordException(err);
+            }
+            span.setStatus({
+              code: "error",
+              message: err instanceof Error ? err.message : String(err)
+            });
+            throw err;
+          }
+        },
+        { kind: "client" }
+      );
+    },
+    // Pass-through methods (no tracing needed for non-chat operations in v1)
+    async complete(request) {
+      return ai.complete(request);
+    },
+    async *completeStream(request) {
+      yield* ai.completeStream(request);
+    },
+    async embed(request) {
+      return ai.embed(request);
+    },
+    async similarity(text1, text2, model) {
+      return ai.similarity(text1, text2, model);
+    },
+    async listModels() {
+      return ai.listModels();
+    },
+    async getModel(modelId) {
+      return ai.getModel(modelId);
+    },
+    async supportsCapability(modelId, capability) {
+      return ai.supportsCapability(modelId, capability);
+    },
+    async estimateTokens(text, model) {
+      return ai.estimateTokens(text, model);
+    },
+    async estimateCost(request) {
+      return ai.estimateCost(request);
+    },
+    async healthCheck() {
+      return ai.healthCheck();
+    }
+  };
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  DEFAULT_AGENT_LOOP_OPTIONS,
+  createAgentTracer,
+  createAgentUsageTracker,
+  createTracedAI,
+  runAgentLoop
+});
+//# sourceMappingURL=agents.js.map

package/dist/agents.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/agents.ts","../src/interfaces/ILogger.ts","../src/agent/agent-loop.ts","../src/agent/agent-tracer.ts","../src/agent/agent-usage.ts","../src/agent/traced-ai.ts"],"sourcesContent":["/**\n * Agents Module\n *\n * Multi-turn tool-calling agent runtime with observability and cost tracking.\n *\n * This sub-path export (`@digilogiclabs/platform-core/agents`) is lightweight —\n * it only depends on IAI, ICache, ITracing, IAIUsage, and ILogger interfaces.\n * It does NOT pull in database, storage, email, payment, or AI provider adapters.\n *\n * @example\n * ```typescript\n * import { runAgentLoop, createTracedAI, createAgentTracer } from '@digilogiclabs/platform-core/agents';\n * ```\n */\n\n// Core agent loop\nexport {\n  runAgentLoop,\n  DEFAULT_AGENT_LOOP_OPTIONS,\n  type AgentTool,\n  type ToolExecutor,\n  type AgentLoopOptions,\n  type AgentLoopResult,\n  type AgentStopReason,\n  type AgentIterationEvent,\n  type AgentIterationCallback,\n  type AgentToolResult,\n  type AgentCumulativeUsage,\n} from \"./agent/agent-loop\";\n\n// Agent tracing helpers\nexport {\n  createAgentTracer,\n  type AgentTracer,\n  type AgentTracerOptions,\n} from \"./agent/agent-tracer\";\n\n// Agent usage tracking\nexport {\n  createAgentUsageTracker,\n  type AgentUsageTracker,\n  type AgentUsageTrackerOptions,\n  type AgentUsageRecordParams,\n  type AgentBudget,\n} from \"./agent/agent-usage\";\n\n// Auto-instrumented AI wrapper\nexport {\n  createTracedAI,\n  type TracedAIOptions,\n} from \"./agent/traced-ai\";\n","/**\n * Logger Interface\n * Standardizes logging across the platform\n */\n\n/**\n * Log levels in order of severity\n */\nexport type LogLevel = \"debug\" | \"info\" | \"warn\" | \"error\";\n\n/**\n * Metadata that can be attached to log entries\n */\nexport interface LogMeta {\n  /** Error object if logging an error */\n  error?: Error;\n  /** Duration in milliseconds (for timing operations) */\n  duration?: number;\n  /** Request ID for tracing */\n  requestId?: string;\n  /** User ID if applicable */\n  userId?: string;\n  /** Any additional key-value pairs */\n  [key: string]: unknown;\n}\n\n/**\n * A structured log entry\n */\nexport interface LogEntry {\n  /** Log level */\n  level: LogLevel;\n  /** Log message */\n  message: string;\n  /** When the log was created */\n  timestamp: Date;\n  /** Optional metadata */\n  meta?: LogMeta;\n  /** Logger context (e.g., service name) */\n  context?: Record<string, unknown>;\n}\n\n/**\n * Logger interface for structured logging\n */\nexport interface ILogger {\n  /**\n   * Log a debug message (for development/troubleshooting)\n   */\n  debug(message: string, meta?: LogMeta): void;\n\n  /**\n   * Log an informational message\n   */\n  info(message: string, meta?: LogMeta): void;\n\n  /**\n   * Log a warning message\n   */\n  warn(message: string, meta?: LogMeta): void;\n\n  /**\n   * Log an error message\n   */\n  error(message: string, meta?: LogMeta): void;\n\n  /**\n   * Create a child logger with additional context\n   * @param context Additional context to include in all logs from this child\n   */\n  child(context: Record<string, unknown>): ILogger;\n}\n\n/**\n * Configuration options for loggers\n */\nexport interface LoggerConfig {\n  /** Minimum level to log */\n  level?: LogLevel;\n  /** Whether to pretty print (for development) */\n  pretty?: boolean;\n  /** Service name to include in logs */\n  service?: string;\n  /** Environment name */\n  environment?: string;\n}\n\n/**\n * Console logger implementation (for development)\n */\nexport class ConsoleLogger implements ILogger {\n  private context: Record<string, unknown>;\n  private level: LogLevel;\n\n  private static levelPriority: Record<LogLevel, number> = {\n    debug: 0,\n    info: 1,\n    warn: 2,\n    error: 3,\n  };\n\n  constructor(config: LoggerConfig = {}) {\n    this.context = {\n      service: config.service,\n      environment: config.environment,\n    };\n    this.level = config.level || \"info\";\n  }\n\n  private shouldLog(level: LogLevel): boolean {\n    return (\n      ConsoleLogger.levelPriority[level] >=\n      ConsoleLogger.levelPriority[this.level]\n    );\n  }\n\n  private log(level: LogLevel, message: string, meta?: LogMeta): void {\n    if (!this.shouldLog(level)) return;\n\n    const entry: LogEntry = {\n      level,\n      message,\n      timestamp: new Date(),\n      meta,\n      context: this.context,\n    };\n\n    const prefix = `[${entry.timestamp.toISOString()}] [${level.toUpperCase()}]`;\n    const contextStr =\n      Object.keys(this.context).length > 0\n        ? ` [${Object.entries(this.context)\n            .map(([k, v]) => `${k}=${v}`)\n            .join(\" \")}]`\n        : \"\";\n\n    switch (level) {\n      case \"debug\":\n        console.debug(`${prefix}${contextStr} ${message}`, meta || \"\");\n        break;\n      case \"info\":\n        console.info(`${prefix}${contextStr} ${message}`, meta || \"\");\n        break;\n      case \"warn\":\n        console.warn(`${prefix}${contextStr} ${message}`, meta || \"\");\n        break;\n      case \"error\":\n        console.error(`${prefix}${contextStr} ${message}`, meta || \"\");\n        if (meta?.error) {\n          console.error(meta.error);\n        }\n        break;\n    }\n  }\n\n  debug(message: string, meta?: LogMeta): void {\n    this.log(\"debug\", message, meta);\n  }\n\n  info(message: string, meta?: LogMeta): void {\n    this.log(\"info\", message, meta);\n  }\n\n  warn(message: string, meta?: LogMeta): void {\n    this.log(\"warn\", message, meta);\n  }\n\n  error(message: string, meta?: LogMeta): void {\n    this.log(\"error\", message, meta);\n  }\n\n  child(context: Record<string, unknown>): ILogger {\n    const childLogger = new ConsoleLogger({ level: this.level });\n    childLogger.context = { ...this.context, ...context };\n    return childLogger;\n  }\n}\n\n/**\n * No-op logger for testing or when logging is disabled\n */\nexport class NoopLogger implements ILogger {\n  debug(): void {}\n  info(): void {}\n  warn(): void {}\n  error(): void {}\n  child(): ILogger {\n    return this;\n  }\n}\n","/**\n * Agent Loop — Multi-turn tool-calling orchestration\n *\n * Runs an IAI chat → tool execution → repeat loop until the AI stops,\n * a budget is hit, or the caller aborts.\n */\n\nimport type {\n  IAI,\n  AIMessage,\n  AITool,\n  AIToolCall,\n  AIChatRequest,\n  AIChatResponse,\n  AIFinishReason,\n} from \"../interfaces/IAI\";\nimport type { ICache } from \"../interfaces/ICache\";\nimport type { ILogger } from \"../interfaces/ILogger\";\nimport { NoopLogger } from \"../interfaces/ILogger\";\n\n// ═══════════════════════════════════════════════════════════════\n// TYPES\n// ═══════════════════════════════════════════════════════════════\n\n/**\n * Function that executes a tool call and returns a string result.\n * Receives the parsed arguments (from JSON) and the raw tool call.\n */\nexport type ToolExecutor = (\n  args: Record<string, unknown>,\n  toolCall: AIToolCall,\n) => Promise<string>;\n\n/**\n * Tool definition paired with its executor.\n */\nexport interface AgentTool {\n  /** The AI tool definition (JSON Schema for the function) */\n  definition: AITool;\n  /** The function that executes this tool */\n  execute: ToolExecutor;\n}\n\n/**\n * Result of a single tool call execution.\n */\nexport interface AgentToolResult {\n  /** The original tool call from the AI */\n  toolCall: AIToolCall;\n  /** The string result returned by the executor */\n  result: string;\n  /** Whether the tool execution succeeded */\n  success: boolean;\n  /** Error message if the tool failed */\n  error?: string;\n  /** Execution duration in ms */\n  durationMs: number;\n  /** Whether the result came from cache */\n  cached: boolean;\n}\n\n/**\n * Cumulative usage across all iterations.\n */\nexport interface AgentCumulativeUsage {\n  promptTokens: number;\n  completionTokens: number;\n  totalTokens: number;\n  estimatedCostUsd: number;\n  iterations: number;\n  toolCallCount: number;\n}\n\n/**\n * Event emitted after each iteration of the agent loop.\n */\nexport interface AgentIterationEvent {\n  /** 1-based iteration number */\n  iteration: number;\n  /** The AI response for this iteration */\n  response: AIChatResponse;\n  /** Tool calls made in this iteration (empty if no tool calls) */\n  toolCalls: AgentToolResult[];\n  /** Cumulative usage across all iterations */\n  cumulativeUsage: AgentCumulativeUsage;\n  /** Full conversation so far */\n  messages: AIMessage[];\n}\n\n/**\n * Callback invoked after each iteration.\n * Return `false` to abort the loop.\n */\nexport type AgentIterationCallback = (\n  event: AgentIterationEvent,\n) => void | false | Promise<void | false>;\n\n/**\n * Why the agent loop stopped.\n */\nexport type AgentStopReason =\n  | \"stop\"\n  | \"max_iterations\"\n  | \"max_tokens\"\n  | \"max_cost\"\n  | \"aborted\"\n  | \"callback_abort\"\n  | \"length\"\n  | \"content_filter\"\n  | \"error\";\n\n/**\n * Options for runAgentLoop.\n */\nexport interface AgentLoopOptions {\n  /** The IAI instance to call */\n  ai: IAI;\n  /** Initial messages (system + user prompt) */\n  messages: AIMessage[];\n  /** Tool definitions with executors */\n  tools: AgentTool[];\n  /** Maximum iterations before forced stop @default 10 */\n  maxIterations: number;\n  /** Maximum cumulative total tokens @default Infinity */\n  maxTokens: number;\n  /** Maximum cumulative cost in USD @default Infinity */\n  maxCostUsd: number;\n  /** Optional cache for tool results */\n  cache?: ICache;\n  /** Cache TTL in seconds for tool results @default 300 */\n  cacheTtlSeconds: number;\n  /** Cache key prefix @default \"agent:tool:\" */\n  cacheKeyPrefix: string;\n  /** Callback after each iteration */\n  onIteration?: AgentIterationCallback;\n  /** AbortSignal for cancellation */\n  signal?: AbortSignal;\n  /** Logger for observability */\n  logger?: ILogger;\n  /** Additional fields for AIChatRequest (model, temperature, etc.) */\n  chatRequestOverrides?: Partial<Omit<AIChatRequest, \"messages\" | \"tools\">>;\n}\n\n/**\n * Result of a completed agent loop.\n */\nexport interface AgentLoopResult {\n  /** Final AI response */\n  response: AIChatResponse;\n  /** Complete conversation history including all tool messages */\n  messages: AIMessage[];\n  /** Why the loop stopped */\n  stopReason: AgentStopReason;\n  /** Per-iteration details */\n  iterations: AgentIterationEvent[];\n  /** Cumulative usage summary */\n  usage: AgentCumulativeUsage;\n}\n\n// ═══════════════════════════════════════════════════════════════\n// DEFAULTS\n// ═══════════════════════════════════════════════════════════════\n\nexport const DEFAULT_AGENT_LOOP_OPTIONS: Pick<\n  AgentLoopOptions,\n  | \"maxIterations\"\n  | \"maxTokens\"\n  | \"maxCostUsd\"\n  | \"cacheTtlSeconds\"\n  | \"cacheKeyPrefix\"\n> = {\n  maxIterations: 10,\n  maxTokens: Infinity,\n  maxCostUsd: Infinity,\n  cacheTtlSeconds: 300,\n  cacheKeyPrefix: \"agent:tool:\",\n};\n\n// ═══════════════════════════════════════════════════════════════\n// HELPERS\n// ═══════════════════════════════════════════════════════════════\n\nfunction mapFinishReason(reason: AIFinishReason): AgentStopReason {\n  switch (reason) {\n    case \"stop\":\n      return \"stop\";\n    case \"length\":\n      return \"length\";\n    case \"content_filter\":\n      return \"content_filter\";\n    case \"tool_calls\":\n      return \"stop\"; // shouldn't reach here in normal flow\n    case \"error\":\n    default:\n      return \"error\";\n  }\n}\n\nasync function executeToolCall(\n  toolCall: AIToolCall,\n  executorMap: Map<string, AgentTool>,\n  cache: ICache | undefined,\n  cacheKeyPrefix: string,\n  cacheTtlSeconds: number,\n): Promise<AgentToolResult> {\n  const start = Date.now();\n  const executor = executorMap.get(toolCall.function.name);\n\n  if (!executor) {\n    return {\n      toolCall,\n      result: `Error: Unknown tool \"${toolCall.function.name}\"`,\n      success: false,\n      error: `Unknown tool: ${toolCall.function.name}`,\n      durationMs: Date.now() - start,\n      cached: false,\n    };\n  }\n\n  // Check cache\n  if (cache) {\n    const cacheKey =\n      cacheKeyPrefix + toolCall.function.name + \":\" + toolCall.function.arguments;\n    try {\n      const cached = await cache.get<string>(cacheKey);\n      if (cached !== null) {\n        return {\n          toolCall,\n          result: cached,\n          success: true,\n          durationMs: Date.now() - start,\n          cached: true,\n        };\n      }\n    } catch {\n      // Cache read failure is non-fatal\n    }\n  }\n\n  // Execute\n  try {\n    const parsed = JSON.parse(toolCall.function.arguments) as Record<\n      string,\n      unknown\n    >;\n    const result = await executor.execute(parsed, toolCall);\n\n    // Store in cache\n    if (cache) {\n      const cacheKey =\n        cacheKeyPrefix + toolCall.function.name + \":\" + toolCall.function.arguments;\n      await cache.set(cacheKey, result, cacheTtlSeconds).catch(() => {});\n    }\n\n    return {\n      toolCall,\n      result,\n      success: true,\n      durationMs: Date.now() - start,\n      cached: false,\n    };\n  } catch (err) {\n    const errorMsg = err instanceof Error ? err.message : String(err);\n    return {\n      toolCall,\n      result: `Error: ${errorMsg}`,\n      success: false,\n      error: errorMsg,\n      durationMs: Date.now() - start,\n      cached: false,\n    };\n  }\n}\n\n// ═══════════════════════════════════════════════════════════════\n// MAIN FUNCTION\n// ═══════════════════════════════════════════════════════════════\n\n/**\n * Run a multi-turn tool-calling agent loop.\n *\n * @example\n * ```typescript\n * const result = await runAgentLoop({\n *   ai: platform.ai,\n *   messages: [\n *     { role: 'system', content: 'You are a helpful assistant.' },\n *     { role: 'user', content: 'What is the weather in London?' },\n *   ],\n *   tools: [{\n *     definition: {\n *       type: 'function',\n *       function: {\n *         name: 'get_weather',\n *         description: 'Get the weather for a city',\n *         parameters: { type: 'object', properties: { city: { type: 'string' } } },\n *       },\n *     },\n *     execute: async (args) => {\n *       const weather = await fetchWeather(args.city as string);\n *       return JSON.stringify(weather);\n *     },\n *   }],\n * });\n *\n * console.log(result.stopReason); // \"stop\"\n * console.log(result.usage.totalTokens); // cumulative tokens\n * ```\n */\nexport async function runAgentLoop(\n  options: Partial<AgentLoopOptions> &\n    Pick<AgentLoopOptions, \"ai\" | \"messages\" | \"tools\">,\n): Promise<AgentLoopResult> {\n  const opts = { ...DEFAULT_AGENT_LOOP_OPTIONS, ...options };\n  const logger = opts.logger ?? new NoopLogger();\n\n  // Build tool definitions and executor map\n  const toolDefs: AITool[] = opts.tools.map((t) => t.definition);\n  const executorMap = new Map<string, AgentTool>();\n  for (const tool of opts.tools) {\n    executorMap.set(tool.definition.function.name, tool);\n  }\n\n  // Mutable state\n  const messages: AIMessage[] = [...opts.messages];\n  const iterations: AgentIterationEvent[] = [];\n  const cumulative: AgentCumulativeUsage = {\n    promptTokens: 0,\n    completionTokens: 0,\n    totalTokens: 0,\n    estimatedCostUsd: 0,\n    iterations: 0,\n    toolCallCount: 0,\n  };\n\n  let lastResponse: AIChatResponse | undefined;\n  let stopReason: AgentStopReason = \"stop\";\n\n  for (let i = 1; i <= opts.maxIterations; i++) {\n    // Check abort signal\n    if (opts.signal?.aborted) {\n      stopReason = \"aborted\";\n      break;\n    }\n\n    // Check budgets before calling AI\n    if (cumulative.totalTokens >= opts.maxTokens) {\n      stopReason = \"max_tokens\";\n      break;\n    }\n    if (cumulative.estimatedCostUsd >= opts.maxCostUsd) {\n      stopReason = \"max_cost\";\n      break;\n    }\n\n    // Call ai.chat()\n    logger.debug(\"Agent loop iteration\", { iteration: i });\n    const chatRequest: AIChatRequest = {\n      ...opts.chatRequestOverrides,\n      messages,\n      tools: toolDefs.length > 0 ? toolDefs : undefined,\n    };\n\n    const response = await opts.ai.chat(chatRequest);\n    lastResponse = response;\n\n    // Accumulate usage\n    cumulative.promptTokens += response.usage.promptTokens;\n    cumulative.completionTokens += response.usage.completionTokens;\n    cumulative.totalTokens += response.usage.totalTokens;\n    cumulative.estimatedCostUsd += response.usage.estimatedCostUsd;\n    cumulative.iterations = i;\n\n    // Get assistant message\n    const assistantMessage = response.choices[0]?.message;\n    if (!assistantMessage) {\n      stopReason = \"error\";\n      break;\n    }\n    messages.push(assistantMessage);\n\n    // If not tool_calls, we're done\n    if (response.finishReason !== \"tool_calls\") {\n      stopReason = mapFinishReason(response.finishReason);\n\n      const event: AgentIterationEvent = {\n        iteration: i,\n        response,\n        toolCalls: [],\n        cumulativeUsage: { ...cumulative },\n        messages: [...messages],\n      };\n      iterations.push(event);\n      await opts.onIteration?.(event);\n      break;\n    }\n\n    // Execute tool calls in parallel\n    const toolCalls = assistantMessage.toolCalls ?? [];\n    cumulative.toolCallCount += toolCalls.length;\n\n    const toolResults: AgentToolResult[] = await Promise.all(\n      toolCalls.map((tc) =>\n        executeToolCall(\n          tc,\n          executorMap,\n          opts.cache,\n          opts.cacheKeyPrefix,\n          opts.cacheTtlSeconds,\n        ),\n      ),\n    );\n\n    // Append tool result messages\n    for (const tr of toolResults) {\n      messages.push({\n        role: \"tool\",\n        content: tr.result,\n        toolCallId: tr.toolCall.id,\n      });\n    }\n\n    // Build iteration event\n    const event: AgentIterationEvent = {\n      iteration: i,\n      response,\n      toolCalls: toolResults,\n      cumulativeUsage: { ...cumulative },\n      messages: [...messages],\n    };\n    iterations.push(event);\n\n    // Fire callback\n    const callbackResult = await opts.onIteration?.(event);\n    if (callbackResult === false) {\n      stopReason = \"callback_abort\";\n      break;\n    }\n\n    // Last iteration check\n    if (i === opts.maxIterations) {\n      stopReason = \"max_iterations\";\n    }\n  }\n\n  return {\n    response: lastResponse!,\n    messages,\n    stopReason,\n    iterations,\n    usage: cumulative,\n  };\n}\n","/**\n * Agent Tracer — OTEL span helpers for agent observability\n *\n * Wraps ITracing with standardized agent-specific span attributes\n * following OpenTelemetry semantic conventions.\n */\n\nimport type { ITracing, ISpan } from \"../interfaces/ITracing\";\nimport type { AgentToolResult, AgentCumulativeUsage } from \"./agent-loop\";\n\n// ═══════════════════════════════════════════════════════════════\n// TYPES\n// ═══════════════════════════════════════════════════════════════\n\nexport interface AgentTracerOptions {\n  /** The ITracing instance */\n  tracing: ITracing;\n  /** Agent identifier for span attributes */\n  agentId: string;\n}\n\nexport interface AgentTracer {\n  /**\n   * Wrap an entire agent loop execution in a span.\n   * Sets `agent.id` on the span.\n   */\n  traceLoop<T>(fn: (span: ISpan) => Promise<T>): Promise<T>;\n\n  /**\n   * Wrap a single iteration in a span.\n   * Sets `agent.iteration` on the span.\n   */\n  traceIteration(\n    iteration: number,\n    fn: (span: ISpan) => Promise<void>,\n  ): Promise<void>;\n\n  /**\n   * Wrap a single tool call execution in a span.\n   * Sets `agent.tool.name`, `agent.tool.duration_ms`, `agent.tool.success`, `agent.tool.cached`.\n   */\n  traceToolCall(\n    toolName: string,\n    fn: (span: ISpan) => Promise<AgentToolResult>,\n  ): Promise<AgentToolResult>;\n\n  /**\n   * Record a decision event on the current span.\n   */\n  traceDecision(\n    span: ISpan,\n    attrs: {\n      finishReason: string;\n      toolCallCount: number;\n      cumulativeUsage: AgentCumulativeUsage;\n    },\n  ): void;\n}\n\n// ═══════════════════════════════════════════════════════════════\n// IMPLEMENTATION\n// ═══════════════════════════════════════════════════════════════\n\n/**\n * Create an agent tracer with standardized OTEL attributes.\n *\n * @example\n * ```typescript\n * const tracer = createAgentTracer({ tracing: platform.tracing, agentId: 'weather-agent' });\n *\n * const result = await tracer.traceLoop(async (span) => {\n *   return await runAgentLoop({ ... });\n * });\n * ```\n */\nexport function createAgentTracer(options: AgentTracerOptions): AgentTracer {\n  const { tracing, agentId } = options;\n\n  return {\n    async traceLoop<T>(fn: (span: ISpan) => Promise<T>): Promise<T> {\n      return tracing.withSpanAsync(\n        \"agent.loop\",\n        async (span) => {\n          span.setAttribute(\"agent.id\", agentId);\n          return fn(span);\n        },\n        { kind: \"internal\" },\n      );\n    },\n\n    async traceIteration(\n      iteration: number,\n      fn: (span: ISpan) => Promise<void>,\n    ): Promise<void> {\n      return tracing.withSpanAsync(\n        \"agent.iteration\",\n        async (span) => {\n          span.setAttributes({\n            \"agent.id\": agentId,\n            \"agent.iteration\": iteration,\n          });\n          return fn(span);\n        },\n        { kind: \"internal\" },\n      );\n    },\n\n    async traceToolCall(\n      toolName: string,\n      fn: (span: ISpan) => Promise<AgentToolResult>,\n    ): Promise<AgentToolResult> {\n      return tracing.withSpanAsync(\n        `agent.tool.${toolName}`,\n        async (span) => {\n          span.setAttributes({\n            \"agent.id\": agentId,\n            \"agent.tool.name\": toolName,\n          });\n          const result = await fn(span);\n          span.setAttributes({\n            \"agent.tool.duration_ms\": result.durationMs,\n            \"agent.tool.success\": result.success,\n            \"agent.tool.cached\": result.cached,\n          });\n          if (result.error) {\n            span.setAttribute(\"agent.tool.error\", result.error);\n          }\n          return result;\n        },\n        { kind: \"internal\" },\n      );\n    },\n\n    traceDecision(\n      span: ISpan,\n      attrs: {\n        finishReason: string;\n        toolCallCount: number;\n        cumulativeUsage: AgentCumulativeUsage;\n      },\n    ): void {\n      span.setAttributes({\n        \"agent.decision.finish_reason\": attrs.finishReason,\n        \"agent.decision.tool_count\": attrs.toolCallCount,\n        \"agent.decision.total_tokens\": attrs.cumulativeUsage.totalTokens,\n        \"agent.decision.cost_usd\": attrs.cumulativeUsage.estimatedCostUsd,\n        \"agent.decision.iterations\": attrs.cumulativeUsage.iterations,\n      });\n      span.addEvent(\"agent.decision\", {\n        finish_reason: attrs.finishReason,\n        tool_count: attrs.toolCallCount,\n      });\n    },\n  };\n}\n","/**\n * Agent Usage Tracker — Per-agent cost tracking via IAIUsage\n *\n * Tags usage records with agentId in metadata for per-agent attribution.\n * No changes to IAIUsage interface required.\n */\n\nimport type { IAIUsage, UsageRecord, UsageCategory } from \"../interfaces/IAIUsage\";\nimport type { AIUsageInfo } from \"../interfaces/IAI\";\nimport type { AgentIterationCallback, AgentIterationEvent } from \"./agent-loop\";\n\n// ═══════════════════════════════════════════════════════════════\n// TYPES\n// ═══════════════════════════════════════════════════════════════\n\nexport interface AgentUsageTrackerOptions {\n  /** The IAIUsage instance */\n  usage: IAIUsage;\n  /** Agent identifier to tag on all records */\n  agentId: string;\n  /** Tenant ID for usage records */\n  tenantId: string;\n  /** Optional user ID */\n  userId?: string;\n}\n\nexport interface AgentUsageRecordParams {\n  /** AI provider name */\n  provider: string;\n  /** Model used */\n  model: string;\n  /** Token usage info from the AI response */\n  usage: AIUsageInfo;\n  /** Usage category @default \"chat\" */\n  category?: UsageCategory;\n  /** Whether the request succeeded @default true */\n  success?: boolean;\n  /** Request latency in ms */\n  latencyMs?: number;\n  /** Error message if failed */\n  error?: string;\n}\n\nexport interface AgentBudget {\n  /** Maximum cumulative cost in USD */\n  maxCostUsd?: number;\n  /** Maximum cumulative tokens */\n  maxTokens?: number;\n}\n\nexport interface AgentUsageTracker {\n  /**\n   * Record a single AI call's usage, tagged with agentId in metadata.\n   */\n  recordIteration(params: AgentUsageRecordParams): Promise<UsageRecord>;\n\n  /**\n   * Returns an AgentIterationCallback suitable for runAgentLoop's onIteration.\n   * Records usage for each iteration and returns false when budget is exceeded.\n   */\n  createBudgetCallback(budget?: AgentBudget): AgentIterationCallback;\n}\n\n// ═══════════════════════════════════════════════════════════════\n// IMPLEMENTATION\n// ═══════════════════════════════════════════════════════════════\n\n/**\n * Create a usage tracker that tags all records with an agent ID.\n *\n * @example\n * ```typescript\n * const tracker = createAgentUsageTracker({\n *   usage: platform.aiUsage,\n *   agentId: 'weather-agent',\n *   tenantId: 'tenant_123',\n * });\n *\n * const result = await runAgentLoop({\n *   ai, messages, tools,\n *   onIteration: tracker.createBudgetCallback({ maxCostUsd: 0.50 }),\n * });\n * ```\n */\nexport function createAgentUsageTracker(\n  options: AgentUsageTrackerOptions,\n): AgentUsageTracker {\n  const { usage, agentId, tenantId, userId } = options;\n\n  return {\n    async recordIteration(params: AgentUsageRecordParams): Promise<UsageRecord> {\n      return usage.record({\n        tenantId,\n        userId,\n        category: params.category ?? \"chat\",\n        provider: params.provider,\n        model: params.model,\n        inputTokens: params.usage.promptTokens,\n        outputTokens: params.usage.completionTokens,\n        totalTokens: params.usage.totalTokens,\n        costUsd: params.usage.estimatedCostUsd,\n        latencyMs: params.latencyMs ?? 0,\n        success: params.success ?? true,\n        error: params.error,\n        metadata: { agentId },\n      });\n    },\n\n    createBudgetCallback(budget?: AgentBudget): AgentIterationCallback {\n      return async (event: AgentIterationEvent): Promise<void | false> => {\n        // Record usage for this iteration\n        const response = event.response;\n        await usage.record({\n          tenantId,\n          userId,\n          category: \"chat\",\n          provider: response.provider,\n          model: response.model,\n          inputTokens: response.usage.promptTokens,\n          outputTokens: response.usage.completionTokens,\n          totalTokens: response.usage.totalTokens,\n          costUsd: response.usage.estimatedCostUsd,\n          latencyMs: 0,\n          success: true,\n          metadata: { agentId, iteration: event.iteration },\n        });\n\n        // Check budget\n        if (budget) {\n          if (\n            budget.maxCostUsd !== undefined &&\n            event.cumulativeUsage.estimatedCostUsd >= budget.maxCostUsd\n          ) {\n            return false;\n          }\n          if (\n            budget.maxTokens !== undefined &&\n            event.cumulativeUsage.totalTokens >= budget.maxTokens\n          ) {\n            return false;\n          }\n        }\n      };\n    },\n  };\n}\n","/**\n * Traced AI — Auto-instrument any IAI with OTEL spans\n *\n * Wraps an IAI instance so that every chat() call is automatically\n * wrapped in an OTEL span capturing provider, model, tokens, cost,\n * latency, and finish reason.\n */\n\nimport type {\n  IAI,\n  AIChatRequest,\n  AIChatResponse,\n  AICompletionRequest,\n  AICompletionResponse,\n  AIEmbeddingRequest,\n  AIEmbeddingResponse,\n  AIStreamChunk,\n  AIStreamCallback,\n  AIModelConfig,\n  AIModelType,\n  AIProvider,\n} from \"../interfaces/IAI\";\nimport type { ITracing } from \"../interfaces/ITracing\";\n\n// ═══════════════════════════════════════════════════════════════\n// TYPES\n// ═══════════════════════════════════════════════════════════════\n\nexport interface TracedAIOptions {\n  /** The IAI instance to wrap */\n  ai: IAI;\n  /** The ITracing instance */\n  tracing: ITracing;\n}\n\n// ═══════════════════════════════════════════════════════════════\n// IMPLEMENTATION\n// ═══════════════════════════════════════════════════════════════\n\n/**\n * Wraps an IAI instance with automatic OTEL tracing on chat operations.\n *\n * @example\n * ```typescript\n * const tracedAI = createTracedAI({ ai: platform.ai, tracing: platform.tracing });\n *\n * // Every chat() call now creates an OTEL span with ai.* attributes\n * const response = await tracedAI.chat({ messages: [...] });\n * ```\n */\nexport function createTracedAI(options: TracedAIOptions): IAI {\n  const { ai, tracing } = options;\n\n  return {\n    async chat(request: AIChatRequest): Promise<AIChatResponse> {\n      return tracing.withSpanAsync(\n        \"ai.chat\",\n        async (span) => {\n          const start = Date.now();\n          if (request.model) {\n            span.setAttribute(\"ai.model\", request.model);\n          }\n\n          try {\n            const response = await ai.chat(request);\n            span.setAttributes({\n              \"ai.provider\": response.provider,\n              \"ai.model\": response.model,\n              \"ai.input_tokens\": response.usage.promptTokens,\n              \"ai.output_tokens\": response.usage.completionTokens,\n              \"ai.total_tokens\": response.usage.totalTokens,\n              \"ai.cost_usd\": response.usage.estimatedCostUsd,\n              \"ai.finish_reason\": response.finishReason,\n              \"ai.latency_ms\": Date.now() - start,\n            });\n            span.setStatus({ code: \"ok\" });\n            return response;\n          } catch (err) {\n            span.setAttributes({\n              \"ai.latency_ms\": Date.now() - start,\n            });\n            if (err instanceof Error) {\n              span.recordException(err);\n            }\n            span.setStatus({\n              code: \"error\",\n              message: err instanceof Error ? err.message : String(err),\n            });\n            throw err;\n          }\n        },\n        { kind: \"client\" },\n      );\n    },\n\n    async *chatStream(request: AIChatRequest): AsyncIterable<AIStreamChunk> {\n      // Delegate directly — tracing streaming is complex and deferred to P4\n      yield* ai.chatStream(request);\n    },\n\n    async chatWithCallback(\n      request: AIChatRequest,\n      callback: AIStreamCallback,\n    ): Promise<AIChatResponse> {\n      return tracing.withSpanAsync(\n        \"ai.chatWithCallback\",\n        async (span) => {\n          const start = Date.now();\n          if (request.model) {\n            span.setAttribute(\"ai.model\", request.model);\n          }\n\n          try {\n            const response = await ai.chatWithCallback(request, callback);\n            span.setAttributes({\n              \"ai.provider\": response.provider,\n              \"ai.model\": response.model,\n              \"ai.input_tokens\": response.usage.promptTokens,\n              \"ai.output_tokens\": response.usage.completionTokens,\n              \"ai.total_tokens\": response.usage.totalTokens,\n              \"ai.cost_usd\": response.usage.estimatedCostUsd,\n              \"ai.finish_reason\": response.finishReason,\n              \"ai.latency_ms\": Date.now() - start,\n            });\n            span.setStatus({ code: \"ok\" });\n            return response;\n          } catch (err) {\n            span.setAttributes({\n              \"ai.latency_ms\": Date.now() - start,\n            });\n            if (err instanceof Error) {\n              span.recordException(err);\n            }\n            span.setStatus({\n              code: \"error\",\n              message: err instanceof Error ? err.message : String(err),\n            });\n            throw err;\n          }\n        },\n        { kind: \"client\" },\n      );\n    },\n\n    // Pass-through methods (no tracing needed for non-chat operations in v1)\n    async complete(request: AICompletionRequest): Promise<AICompletionResponse> {\n      return ai.complete(request);\n    },\n\n    async *completeStream(\n      request: AICompletionRequest,\n    ): AsyncIterable<AIStreamChunk> {\n      yield* ai.completeStream(request);\n    },\n\n    async embed(request: AIEmbeddingRequest): Promise<AIEmbeddingResponse> {\n      return ai.embed(request);\n    },\n\n    async similarity(\n      text1: string,\n      text2: string,\n      model?: string,\n    ): Promise<number> {\n      return ai.similarity(text1, text2, model);\n    },\n\n    async listModels(): Promise<AIModelConfig[]> {\n      return ai.listModels();\n    },\n\n    async getModel(modelId: string): Promise<AIModelConfig | null> {\n      return ai.getModel(modelId);\n    },\n\n    async supportsCapability(\n      modelId: string,\n      capability: AIModelType,\n    ): Promise<boolean> {\n      return ai.supportsCapability(modelId, capability);\n    },\n\n    async estimateTokens(text: string, model?: string): Promise<number> {\n      return ai.estimateTokens(text, model);\n    },\n\n    async estimateCost(request: AIChatRequest | AICompletionRequest | AIEmbeddingRequest): Promise<number> {\n      return ai.estimateCost(request);\n    },\n\n    async healthCheck(): Promise<{\n      healthy: boolean;\n      providers: Record<\n        AIProvider,\n        { available: boolean; latencyMs?: number; error?: string }\n      >;\n    }> {\n      return ai.healthCheck();\n    },\n  };\n}\n"],"mappings":"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","names":["event"]}