@directive-run/ai 0.2.0 → 0.3.0

package/dist/openai.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/helpers.ts","../src/adapters/openai.ts"],"names":["ALLOWED_PROTOCOLS","validateBaseURL","baseURL","url","err","createRunner","options","fetchFn","buildRequest","parseResponse","parseOutput","hooks","parse","text","agent","input","runOptions","startTime","messages","init","fetchInit","response","errBody","parsed","tokenUsage","assistantMessage","allMessages","durationMs","OPENAI_PRICING","createOpenAIRunner","apiKey","model","maxTokens","timeoutMs","_input","m","res","data","inputTokens","outputTokens","createOpenAIEmbedder","dimensions","entry","createOpenAIStreamingRunner","callbacks","reader","decoder","buf","fullText","promptTokens","completionTokens","done","value","lines","line","event","delta","parseErr","assistantMsg","totalTokens"],"mappings":"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","file":"openai.js","sourcesContent":["/**\n * Helper functions for AI adapter — createRunner, estimateCost, state queries, validation.\n */\n\nimport type {\n  AdapterHooks,\n  AgentLike,\n  AgentRunner,\n  RunResult,\n  RunOptions,\n  Message,\n  TokenUsage,\n  AgentState,\n  ApprovalState,\n} from \"./types.js\";\n\n// ============================================================================\n// State Query Helpers\n// ============================================================================\n\n/** Check if agent is currently running. */\nexport function isAgentRunning(state: AgentState): boolean {\n  return state.status === \"running\";\n}\n\n/** Check if there are pending approvals. */\nexport function hasPendingApprovals(state: ApprovalState): boolean {\n  return state.pending.length > 0;\n}\n\n// ============================================================================\n// Cost Estimation\n// ============================================================================\n\n/**\n * Get total cost estimate based on token usage.\n *\n * @param tokenUsage - Total token count\n * @param ratePerMillionTokens - Cost per million tokens (required, no default to avoid stale pricing)\n * @returns Estimated cost in dollars\n */\nexport function estimateCost(\n  tokenUsage: number,\n  ratePerMillionTokens: number\n): number {\n  return (tokenUsage / 1_000_000) * ratePerMillionTokens;\n}\n\n// ============================================================================\n// Validation Helpers\n// ============================================================================\n\nconst ALLOWED_PROTOCOLS = new Set([\"http:\", \"https:\"]);\n\n/**\n * Validate that a baseURL uses http or https.\n * Throws immediately at adapter creation time (not at call time) to catch config errors early.\n */\nexport function validateBaseURL(baseURL: string): void {\n  try {\n    const url = new URL(baseURL);\n    if (!ALLOWED_PROTOCOLS.has(url.protocol)) {\n      throw new Error(\n        `[Directive] Invalid baseURL protocol \"${url.protocol}\" – only http: and https: are allowed`,\n      );\n    }\n  } catch (err) {\n    if (err instanceof Error && err.message.startsWith(\"[Directive]\")) {\n      throw err;\n    }\n\n    throw new Error(\n      `[Directive] Invalid baseURL \"${baseURL}\" – must be a valid URL (e.g. \"https://api.openai.com/v1\")`,\n    );\n  }\n}\n\n// ============================================================================\n// createRunner Helper\n// ============================================================================\n\n/** Parsed response from an LLM provider */\nexport interface ParsedResponse {\n  text: string;\n  totalTokens: number;\n  /** Input token count, when available from the provider */\n  inputTokens?: number;\n  /** Output token count, when available from the provider */\n  outputTokens?: number;\n}\n\n/** Options for creating an AgentRunner from buildRequest/parseResponse */\nexport interface CreateRunnerOptions {\n  fetch?: typeof globalThis.fetch;\n  buildRequest: (\n    agent: AgentLike,\n    input: string,\n    messages: Message[]\n  ) => { url: string; init: RequestInit };\n  parseResponse: (\n    response: Response,\n    messages: Message[]\n  ) => Promise<ParsedResponse>;\n  parseOutput?: <T>(text: string) => T;\n  /** Lifecycle hooks for tracing, logging, and metrics */\n  hooks?: AdapterHooks;\n}\n\n/**\n * Create an AgentRunner from buildRequest/parseResponse helpers.\n * Reduces ~50 lines of fetch boilerplate to ~20 lines of configuration.\n *\n * Supports lifecycle hooks for observability:\n * - `onBeforeCall` fires before each API request\n * - `onAfterCall` fires after a successful response (includes token breakdown)\n * - `onError` fires when the request fails\n *\n * @example\n * ```typescript\n * const runClaude = createRunner({\n *   buildRequest: (agent, input) => ({\n *     url: \"/api/claude\",\n *     init: {\n *       method: \"POST\",\n *       headers: { \"Content-Type\": \"application/json\" },\n *       body: JSON.stringify({\n *         model: agent.model ?? \"claude-haiku-4-5-20251001\",\n *         system: agent.instructions ?? \"\",\n *         messages: [{ role: \"user\", content: input }],\n *       }),\n *     },\n *   }),\n *   parseResponse: async (res) => {\n *     const data = await res.json();\n *     const inputTokens = data.usage?.input_tokens ?? 0;\n *     const outputTokens = data.usage?.output_tokens ?? 0;\n *     return {\n *       text: data.content?.[0]?.text ?? \"\",\n *       totalTokens: inputTokens + outputTokens,\n *       inputTokens,\n *       outputTokens,\n *     };\n *   },\n *   hooks: {\n *     onAfterCall: ({ durationMs, tokenUsage }) => {\n *       console.log(`LLM call: ${durationMs}ms, ${tokenUsage.inputTokens}in/${tokenUsage.outputTokens}out`);\n *     },\n *   },\n * });\n * ```\n */\nexport function createRunner(options: CreateRunnerOptions): AgentRunner {\n  const {\n    fetch: fetchFn = globalThis.fetch,\n    buildRequest,\n    parseResponse,\n    parseOutput,\n    hooks,\n  } = options;\n\n  const defaultParseOutput = <T>(text: string): T => {\n    try {\n      return JSON.parse(text) as T;\n    } catch {\n      return text as unknown as T;\n    }\n  };\n\n  const parse = parseOutput ?? defaultParseOutput;\n\n  return async <T = unknown>(\n    agent: AgentLike,\n    input: string,\n    runOptions?: RunOptions\n  ): Promise<RunResult<T>> => {\n    const startTime = Date.now();\n    hooks?.onBeforeCall?.({ agent, input, timestamp: startTime });\n\n    const messages: Message[] = [{ role: \"user\", content: input }];\n\n    try {\n      const { url, init } = buildRequest(agent, input, messages);\n\n      const fetchInit: RequestInit = runOptions?.signal\n        ? { ...init, signal: runOptions.signal }\n        : init;\n\n      const response = await fetchFn(url, fetchInit);\n\n      if (!response.ok) {\n        const errBody = await response.text().catch(() => \"\");\n\n        throw new Error(\n          `[Directive] AgentRunner request failed: ${response.status} ${response.statusText}${errBody ? ` – ${errBody.slice(0, 300)}` : \"\"}`,\n        );\n      }\n\n      const parsed = await parseResponse(response, messages);\n      const tokenUsage: TokenUsage = {\n        inputTokens: parsed.inputTokens ?? 0,\n        outputTokens: parsed.outputTokens ?? 0,\n      };\n\n      const assistantMessage: Message = { role: \"assistant\", content: parsed.text };\n      const allMessages: Message[] = [...messages, assistantMessage];\n\n      runOptions?.onMessage?.(assistantMessage);\n\n      const durationMs = Date.now() - startTime;\n      hooks?.onAfterCall?.({\n        agent,\n        input,\n        output: parsed.text,\n        totalTokens: parsed.totalTokens,\n        tokenUsage,\n        durationMs,\n        timestamp: Date.now(),\n      });\n\n      return {\n        output: parse<T>(parsed.text),\n        messages: allMessages,\n        toolCalls: [],\n        totalTokens: parsed.totalTokens,\n        tokenUsage,\n      };\n    } catch (err) {\n      const durationMs = Date.now() - startTime;\n      if (err instanceof Error) {\n        hooks?.onError?.({\n          agent,\n          input,\n          error: err,\n          durationMs,\n          timestamp: Date.now(),\n        });\n      }\n\n      throw err;\n    }\n  };\n}\n","/**\n * @directive-run/ai/openai\n *\n * OpenAI adapter for Directive AI. Provides runners and embedders\n * for OpenAI-compatible APIs (OpenAI, Azure, Together, etc.)\n *\n * @example\n * ```typescript\n * import { createOpenAIRunner, createOpenAIEmbedder } from '@directive-run/ai/openai';\n *\n * const runner = createOpenAIRunner({ apiKey: process.env.OPENAI_API_KEY! });\n * const embedder = createOpenAIEmbedder({ apiKey: process.env.OPENAI_API_KEY! });\n * ```\n */\n\nimport { createRunner, validateBaseURL } from \"../helpers.js\";\nimport type { AdapterHooks, AgentRunner, Message, TokenUsage } from \"../types.js\";\nimport type { StreamingCallbackRunner } from \"../stack.js\";\nimport type { EmbedderFn, Embedding } from \"../guardrails/semantic-cache.js\";\n\n// ============================================================================\n// Pricing Constants\n// ============================================================================\n\n/**\n * OpenAI model pricing (USD per million tokens).\n *\n * Use with `estimateCost()` for per-call cost tracking:\n * ```typescript\n * import { estimateCost } from '@directive-run/ai';\n * import { OPENAI_PRICING } from '@directive-run/ai/openai';\n *\n * const cost =\n *   estimateCost(result.tokenUsage!.inputTokens, OPENAI_PRICING[\"gpt-4o\"].input) +\n *   estimateCost(result.tokenUsage!.outputTokens, OPENAI_PRICING[\"gpt-4o\"].output);\n * ```\n *\n * **Note:** Pricing changes over time. These values are provided as a convenience\n * and may not reflect the latest rates. Always verify at https://openai.com/pricing\n */\nexport const OPENAI_PRICING: Record<string, { input: number; output: number }> = {\n\t\"gpt-4o\": { input: 2.5, output: 10 },\n\t\"gpt-4o-mini\": { input: 0.15, output: 0.6 },\n\t\"gpt-4-turbo\": { input: 10, output: 30 },\n\t\"o3-mini\": { input: 1.1, output: 4.4 },\n};\n\n// ============================================================================\n// OpenAI Runner\n// ============================================================================\n\n/** Options for createOpenAIRunner */\nexport interface OpenAIRunnerOptions {\n\tapiKey: string;\n\tmodel?: string;\n\tmaxTokens?: number;\n\tbaseURL?: string;\n\tfetch?: typeof globalThis.fetch;\n\t/** @default undefined */\n\ttimeoutMs?: number;\n\t/** Lifecycle hooks for tracing, logging, and metrics */\n\thooks?: AdapterHooks;\n}\n\n/**\n * Create an AgentRunner for OpenAI-compatible APIs (OpenAI, Azure, Together, etc.)\n *\n * Returns `tokenUsage` with input/output breakdown for cost tracking.\n *\n * @example\n * ```typescript\n * // OpenAI\n * const runner = createOpenAIRunner({ apiKey: process.env.OPENAI_API_KEY! });\n *\n * // Azure OpenAI\n * const azure = createOpenAIRunner({\n *   apiKey: process.env.AZURE_KEY!,\n *   baseURL: \"https://your-resource.openai.azure.com/v1\",\n * });\n *\n * // Together.ai (OpenAI-compatible)\n * const together = createOpenAIRunner({\n *   apiKey: process.env.TOGETHER_KEY!,\n *   baseURL: \"https://api.together.xyz/v1\",\n * });\n * ```\n */\nexport function createOpenAIRunner(options: OpenAIRunnerOptions): AgentRunner {\n\tconst {\n\t\tapiKey,\n\t\tmodel = \"gpt-4o\",\n\t\tmaxTokens,\n\t\tbaseURL = \"https://api.openai.com/v1\",\n\t\tfetch: fetchFn = globalThis.fetch,\n\t\ttimeoutMs,\n\t\thooks,\n\t} = options;\n\n\tvalidateBaseURL(baseURL);\n\n\tif (typeof process !== \"undefined\" && process.env?.NODE_ENV !== \"production\" && !apiKey) {\n\t\tconsole.warn(\"[Directive] createOpenAIRunner: apiKey is empty. API calls will fail.\");\n\t}\n\n\treturn createRunner({\n\t\tfetch: fetchFn,\n\t\thooks,\n\t\tbuildRequest: (agent, _input, messages) => ({\n\t\t\turl: `${baseURL}/chat/completions`,\n\t\t\tinit: {\n\t\t\t\tmethod: \"POST\",\n\t\t\t\theaders: {\n\t\t\t\t\t\"Content-Type\": \"application/json\",\n\t\t\t\t\tAuthorization: `Bearer ${apiKey}`,\n\t\t\t\t},\n\t\t\t\tbody: JSON.stringify({\n\t\t\t\t\tmodel: agent.model ?? model,\n\t\t\t\t\t...(maxTokens != null ? { max_tokens: maxTokens } : {}),\n\t\t\t\t\tmessages: [\n\t\t\t\t\t\t...(agent.instructions\n\t\t\t\t\t\t\t? [{ role: \"system\", content: agent.instructions }]\n\t\t\t\t\t\t\t: []),\n\t\t\t\t\t\t...messages.map((m) => ({ role: m.role, content: m.content })),\n\t\t\t\t\t],\n\t\t\t\t}),\n\t\t\t\t...(timeoutMs != null ? { signal: AbortSignal.timeout(timeoutMs) } : {}),\n\t\t\t},\n\t\t}),\n\t\tparseResponse: async (res) => {\n\t\t\tconst data = await res.json();\n\t\t\tconst text = data.choices?.[0]?.message?.content ?? \"\";\n\t\t\tconst inputTokens = data.usage?.prompt_tokens ?? 0;\n\t\t\tconst outputTokens = data.usage?.completion_tokens ?? 0;\n\n\t\t\treturn {\n\t\t\t\ttext,\n\t\t\t\ttotalTokens: inputTokens + outputTokens,\n\t\t\t\tinputTokens,\n\t\t\t\toutputTokens,\n\t\t\t};\n\t\t},\n\t});\n}\n\n// ============================================================================\n// OpenAI Embedder\n// ============================================================================\n\n/** Options for createOpenAIEmbedder */\nexport interface OpenAIEmbedderOptions {\n\tapiKey: string;\n\tmodel?: string;\n\tdimensions?: number;\n\tbaseURL?: string;\n\tfetch?: typeof globalThis.fetch;\n\t/** @default 30000 */\n\ttimeoutMs?: number;\n}\n\n/**\n * Create an EmbedderFn that calls the OpenAI embeddings API.\n *\n * @example\n * ```typescript\n * const embedder = createOpenAIEmbedder({ apiKey: process.env.OPENAI_API_KEY! });\n * const embedding = await embedder('How do constraints work?');\n * ```\n */\nexport function createOpenAIEmbedder(\n\toptions: OpenAIEmbedderOptions,\n): EmbedderFn {\n\tconst {\n\t\tapiKey,\n\t\tmodel = \"text-embedding-3-small\",\n\t\tdimensions = 1536,\n\t\tbaseURL = \"https://api.openai.com/v1\",\n\t\tfetch: fetchFn = globalThis.fetch,\n\t\ttimeoutMs,\n\t} = options;\n\n\tvalidateBaseURL(baseURL);\n\n\tif (typeof process !== \"undefined\" && process.env?.NODE_ENV !== \"production\" && !apiKey) {\n\t\tconsole.warn(\"[Directive] createOpenAIEmbedder: apiKey is empty. API calls will fail.\");\n\t}\n\n\treturn async (text: string): Promise<Embedding> => {\n\t\tconst response = await fetchFn(`${baseURL}/embeddings`, {\n\t\t\tmethod: \"POST\",\n\t\t\theaders: {\n\t\t\t\t\"Content-Type\": \"application/json\",\n\t\t\t\tAuthorization: `Bearer ${apiKey}`,\n\t\t\t},\n\t\t\tbody: JSON.stringify({ model, input: text, dimensions }),\n\t\t\tsignal: AbortSignal.timeout(timeoutMs ?? 30_000),\n\t\t});\n\n\t\tif (!response.ok) {\n\t\t\tconst errBody = await response.text().catch(() => \"\");\n\n\t\t\tthrow new Error(\n\t\t\t\t`[Directive] OpenAI embedding failed: ${response.status}${errBody ? ` – ${errBody.slice(0, 200)}` : \"\"}`,\n\t\t\t);\n\t\t}\n\n\t\tconst data = (await response.json()) as {\n\t\t\tdata: Array<{ embedding: number[] }>;\n\t\t};\n\n\t\tconst entry = data.data[0];\n\t\tif (!entry) {\n\t\t\tthrow new Error(\n\t\t\t\t\"[Directive] OpenAI embedding response contained no data entries\",\n\t\t\t);\n\t\t}\n\n\t\treturn entry.embedding;\n\t};\n}\n\n// ============================================================================\n// OpenAI Streaming Runner\n// ============================================================================\n\n/** Options for createOpenAIStreamingRunner */\nexport interface OpenAIStreamingRunnerOptions {\n\tapiKey: string;\n\tmodel?: string;\n\tmaxTokens?: number;\n\tbaseURL?: string;\n\tfetch?: typeof globalThis.fetch;\n\t/** Lifecycle hooks for tracing, logging, and metrics */\n\thooks?: AdapterHooks;\n}\n\n/**\n * Create a StreamingCallbackRunner for OpenAI-compatible chat completions\n * with server-sent events. Can be used standalone or paired with `createOpenAIRunner`.\n *\n * Returns `tokenUsage` with input/output breakdown for cost tracking.\n *\n * @example\n * ```typescript\n * const streamingRunner = createOpenAIStreamingRunner({\n *   apiKey: process.env.OPENAI_API_KEY!,\n * });\n * const stack = createAgentStack({\n *   runner: createOpenAIRunner({ apiKey }),\n *   streaming: { runner: streamingRunner },\n *   agents: { ... },\n * });\n * ```\n */\nexport function createOpenAIStreamingRunner(\n\toptions: OpenAIStreamingRunnerOptions,\n): StreamingCallbackRunner {\n\tconst {\n\t\tapiKey,\n\t\tmodel = \"gpt-4o\",\n\t\tmaxTokens,\n\t\tbaseURL = \"https://api.openai.com/v1\",\n\t\tfetch: fetchFn = globalThis.fetch,\n\t\thooks,\n\t} = options;\n\n\tvalidateBaseURL(baseURL);\n\n\tif (typeof process !== \"undefined\" && process.env?.NODE_ENV !== \"production\" && !apiKey) {\n\t\tconsole.warn(\"[Directive] createOpenAIStreamingRunner: apiKey is empty. API calls will fail.\");\n\t}\n\n\treturn async (agent, input, callbacks) => {\n\t\tconst startTime = Date.now();\n\t\thooks?.onBeforeCall?.({ agent, input, timestamp: startTime });\n\n\t\ttry {\n\t\t\tconst response = await fetchFn(`${baseURL}/chat/completions`, {\n\t\t\t\tmethod: \"POST\",\n\t\t\t\theaders: {\n\t\t\t\t\t\"Content-Type\": \"application/json\",\n\t\t\t\t\tAuthorization: `Bearer ${apiKey}`,\n\t\t\t\t},\n\t\t\t\tbody: JSON.stringify({\n\t\t\t\t\tmodel: agent.model ?? model,\n\t\t\t\t\t...(maxTokens != null ? { max_tokens: maxTokens } : {}),\n\t\t\t\t\tmessages: [\n\t\t\t\t\t\t...(agent.instructions\n\t\t\t\t\t\t\t? [{ role: \"system\", content: agent.instructions }]\n\t\t\t\t\t\t\t: []),\n\t\t\t\t\t\t{ role: \"user\", content: input },\n\t\t\t\t\t],\n\t\t\t\t\tstream: true,\n\t\t\t\t\tstream_options: { include_usage: true },\n\t\t\t\t}),\n\t\t\t\tsignal: callbacks.signal,\n\t\t\t});\n\n\t\t\tif (!response.ok) {\n\t\t\t\tconst errBody = await response.text().catch(() => \"\");\n\n\t\t\t\tthrow new Error(\n\t\t\t\t\t`[Directive] OpenAI streaming error ${response.status}${errBody ? ` – ${errBody.slice(0, 200)}` : \"\"}`,\n\t\t\t\t);\n\t\t\t}\n\n\t\t\tconst reader = response.body?.getReader();\n\t\t\tif (!reader) {\n\t\t\t\tthrow new Error(\"[Directive] No response body\");\n\t\t\t}\n\n\t\t\tconst decoder = new TextDecoder();\n\t\t\tlet buf = \"\";\n\t\t\tlet fullText = \"\";\n\t\t\tlet promptTokens = 0;\n\t\t\tlet completionTokens = 0;\n\n\t\t\ttry {\n\t\t\t\twhile (true) {\n\t\t\t\t\tconst { done, value } = await reader.read();\n\t\t\t\t\tif (done) {\n\t\t\t\t\t\tbreak;\n\t\t\t\t\t}\n\n\t\t\t\t\tbuf += decoder.decode(value, { stream: true });\n\t\t\t\t\tconst lines = buf.split(\"\\n\");\n\t\t\t\t\tbuf = lines.pop() ?? \"\";\n\n\t\t\t\t\tfor (const line of lines) {\n\t\t\t\t\t\tif (!line.startsWith(\"data: \")) {\n\t\t\t\t\t\t\tcontinue;\n\t\t\t\t\t\t}\n\t\t\t\t\t\tconst data = line.slice(6).trim();\n\t\t\t\t\t\tif (data === \"[DONE]\") {\n\t\t\t\t\t\t\tcontinue;\n\t\t\t\t\t\t}\n\n\t\t\t\t\t\ttry {\n\t\t\t\t\t\t\tconst event = JSON.parse(data);\n\n\t\t\t\t\t\t\t// Extract token content from delta\n\t\t\t\t\t\t\tconst delta = event.choices?.[0]?.delta;\n\t\t\t\t\t\t\tif (delta?.content) {\n\t\t\t\t\t\t\t\tfullText += delta.content;\n\t\t\t\t\t\t\t\tcallbacks.onToken?.(delta.content);\n\t\t\t\t\t\t\t}\n\n\t\t\t\t\t\t\t// Extract usage from the final chunk (stream_options: include_usage)\n\t\t\t\t\t\t\tif (event.usage) {\n\t\t\t\t\t\t\t\tpromptTokens = event.usage.prompt_tokens ?? 0;\n\t\t\t\t\t\t\t\tcompletionTokens = event.usage.completion_tokens ?? 0;\n\t\t\t\t\t\t\t}\n\t\t\t\t\t\t} catch (parseErr) {\n\t\t\t\t\t\t\tif (parseErr instanceof SyntaxError) {\n\t\t\t\t\t\t\t\tif (\n\t\t\t\t\t\t\t\t\ttypeof process !== \"undefined\" &&\n\t\t\t\t\t\t\t\t\tprocess.env?.NODE_ENV === \"development\"\n\t\t\t\t\t\t\t\t) {\n\t\t\t\t\t\t\t\t\tconsole.warn(\n\t\t\t\t\t\t\t\t\t\t\"[Directive] Malformed SSE event from OpenAI:\",\n\t\t\t\t\t\t\t\t\t\tdata,\n\t\t\t\t\t\t\t\t\t);\n\t\t\t\t\t\t\t\t}\n\t\t\t\t\t\t\t} else {\n\t\t\t\t\t\t\t\tthrow parseErr;\n\t\t\t\t\t\t\t}\n\t\t\t\t\t\t}\n\t\t\t\t\t}\n\t\t\t\t}\n\t\t\t} finally {\n\t\t\t\treader.cancel().catch(() => {});\n\t\t\t}\n\n\t\t\tconst assistantMsg: Message = { role: \"assistant\", content: fullText };\n\t\t\tcallbacks.onMessage?.(assistantMsg);\n\n\t\t\tconst tokenUsage: TokenUsage = {\n\t\t\t\tinputTokens: promptTokens,\n\t\t\t\toutputTokens: completionTokens,\n\t\t\t};\n\t\t\tconst totalTokens = promptTokens + completionTokens;\n\n\t\t\thooks?.onAfterCall?.({\n\t\t\t\tagent,\n\t\t\t\tinput,\n\t\t\t\toutput: fullText,\n\t\t\t\ttotalTokens,\n\t\t\t\ttokenUsage,\n\t\t\t\tdurationMs: Date.now() - startTime,\n\t\t\t\ttimestamp: Date.now(),\n\t\t\t});\n\n\t\t\treturn {\n\t\t\t\toutput: fullText,\n\t\t\t\tmessages: [{ role: \"user\" as const, content: input }, assistantMsg],\n\t\t\t\ttoolCalls: [],\n\t\t\t\ttotalTokens,\n\t\t\t\ttokenUsage,\n\t\t\t};\n\t\t} catch (err) {\n\t\t\tif (err instanceof Error) {\n\t\t\t\thooks?.onError?.({\n\t\t\t\t\tagent,\n\t\t\t\t\tinput,\n\t\t\t\t\terror: err,\n\t\t\t\t\tdurationMs: Date.now() - startTime,\n\t\t\t\t\ttimestamp: Date.now(),\n\t\t\t\t});\n\t\t\t}\n\n\t\t\tthrow err;\n\t\t}\n\t};\n}\n"]}
+{"version":3,"sources":["../src/agent-utils.ts","../src/adapters/openai.ts"],"names":["ALLOWED_PROTOCOLS","validateBaseURL","baseURL","url","err","createRunner","options","fetchFn","buildRequest","parseResponse","parseOutput","hooks","parse","text","agent","input","runOptions","startTime","messages","init","fetchInit","response","errBody","parsed","tokenUsage","assistantMessage","allMessages","durationMs","OPENAI_PRICING","createOpenAIRunner","apiKey","model","maxTokens","timeoutMs","_input","m","res","data","inputTokens","outputTokens","createOpenAIEmbedder","dimensions","entry","createOpenAIStreamingRunner","callbacks","reader","decoder","buf","fullText","promptTokens","completionTokens","done","value","lines","line","event","delta","parseErr","assistantMsg","totalTokens"],"mappings":"AAoDA,IAAMA,CAAAA,CAAoB,IAAI,GAAA,CAAI,CAAC,QAAS,QAAQ,CAAC,CAAA,CAM9C,SAASC,CAAAA,CAAgBC,CAAAA,CAAuB,CACrD,GAAI,CACF,IAAMC,CAAAA,CAAM,IAAI,GAAA,CAAID,CAAO,CAAA,CAC3B,GAAI,CAACF,CAAAA,CAAkB,GAAA,CAAIG,CAAAA,CAAI,QAAQ,CAAA,CACrC,MAAM,IAAI,KAAA,CACR,CAAA,sCAAA,EAAyCA,CAAAA,CAAI,QAAQ,CAAA,0CAAA,CACvD,CAEJ,CAAA,MAASC,CAAAA,CAAK,CACZ,MAAIA,aAAe,KAAA,EAASA,CAAAA,CAAI,OAAA,CAAQ,UAAA,CAAW,aAAa,CAAA,CACxDA,EAGF,IAAI,KAAA,CACR,CAAA,6BAAA,EAAgCF,CAAO,CAAA,+DAAA,CACzC,CACF,CACF,CA4EO,SAASG,CAAAA,CAAaC,CAAAA,CAA2C,CACtE,GAAM,CACJ,KAAA,CAAOC,CAAAA,CAAU,UAAA,CAAW,KAAA,CAC5B,YAAA,CAAAC,CAAAA,CACA,cAAAC,CAAAA,CACA,WAAA,CAAAC,CAAAA,CACA,KAAA,CAAAC,CACF,CAAA,CAAIL,EAUEM,CAAAA,CAAQF,CAAAA,GARiBG,CAAAA,EAAoB,CACjD,GAAI,CACF,OAAO,IAAA,CAAK,KAAA,CAAMA,CAAI,CACxB,CAAA,KAAQ,CACN,OAAOA,CACT,CACF,CAAA,CAAA,CAIA,OAAO,MACLC,CAAAA,CACAC,EACAC,CAAAA,GAC0B,CAC1B,IAAMC,CAAAA,CAAY,IAAA,CAAK,GAAA,GACvBN,CAAAA,EAAO,YAAA,GAAe,CAAE,KAAA,CAAAG,CAAAA,CAAO,KAAA,CAAAC,EAAO,SAAA,CAAWE,CAAU,CAAC,CAAA,CAE5D,IAAMC,EAAsB,CAAC,CAAE,IAAA,CAAM,MAAA,CAAQ,OAAA,CAASH,CAAM,CAAC,CAAA,CAE7D,GAAI,CACF,GAAM,CAAE,GAAA,CAAAZ,EAAK,IAAA,CAAAgB,CAAK,CAAA,CAAIX,CAAAA,CAAaM,CAAAA,CAAOC,CAAAA,CAAOG,CAAQ,CAAA,CAEnDE,CAAAA,CAAyBJ,CAAAA,EAAY,MAAA,CACvC,CAAE,GAAGG,EAAM,MAAA,CAAQH,CAAAA,CAAW,MAAO,CAAA,CACrCG,CAAAA,CAEEE,CAAAA,CAAW,MAAMd,CAAAA,CAAQJ,CAAAA,CAAKiB,CAAS,CAAA,CAE7C,GAAI,CAACC,EAAS,EAAA,CAAI,CAChB,IAAMC,CAAAA,CAAU,MAAMD,CAAAA,CAAS,MAAK,CAAE,KAAA,CAAM,IAAM,EAAE,CAAA,CAEpD,MAAM,IAAI,KAAA,CACR,CAAA,wCAAA,EAA2CA,CAAAA,CAAS,MAAM,CAAA,CAAA,EAAIA,CAAAA,CAAS,UAAU,CAAA,EAAGC,CAAAA,CAAU,CAAA,QAAA,EAAMA,CAAAA,CAAQ,KAAA,CAAM,CAAA,CAAG,GAAG,CAAC,CAAA,CAAA,CAAK,EAAE,CAAA,CAClI,CACF,CAEA,IAAMC,CAAAA,CAAS,MAAMd,CAAAA,CAAcY,CAAAA,CAAUH,CAAQ,CAAA,CAC/CM,EAAyB,CAC7B,WAAA,CAAaD,CAAAA,CAAO,WAAA,EAAe,CAAA,CACnC,YAAA,CAAcA,EAAO,YAAA,EAAgB,CACvC,CAAA,CAEME,CAAAA,CAA4B,CAAE,IAAA,CAAM,YAAa,OAAA,CAASF,CAAAA,CAAO,IAAK,CAAA,CACtEG,CAAAA,CAAyB,CAAC,GAAGR,CAAAA,CAAUO,CAAgB,EAE7DT,CAAAA,EAAY,SAAA,GAAYS,CAAgB,CAAA,CAExC,IAAME,CAAAA,CAAa,IAAA,CAAK,GAAA,EAAI,CAAIV,EAChC,OAAAN,CAAAA,EAAO,WAAA,GAAc,CACnB,KAAA,CAAAG,CAAAA,CACA,MAAAC,CAAAA,CACA,MAAA,CAAQQ,CAAAA,CAAO,IAAA,CACf,WAAA,CAAaA,CAAAA,CAAO,YACpB,UAAA,CAAAC,CAAAA,CACA,UAAA,CAAAG,CAAAA,CACA,SAAA,CAAW,IAAA,CAAK,KAClB,CAAC,CAAA,CAEM,CACL,MAAA,CAAQf,CAAAA,CAASW,EAAO,IAAI,CAAA,CAC5B,QAAA,CAAUG,CAAAA,CACV,SAAA,CAAW,GACX,WAAA,CAAaH,CAAAA,CAAO,WAAA,CACpB,UAAA,CAAAC,CACF,CACF,OAASpB,CAAAA,CAAK,CACZ,IAAMuB,CAAAA,CAAa,IAAA,CAAK,GAAA,GAAQV,CAAAA,CAChC,MAAIb,CAAAA,YAAe,KAAA,EACjBO,CAAAA,EAAO,OAAA,GAAU,CACf,KAAA,CAAAG,CAAAA,CACA,KAAA,CAAAC,CAAAA,CACA,KAAA,CAAOX,CAAAA,CACP,WAAAuB,CAAAA,CACA,SAAA,CAAW,IAAA,CAAK,GAAA,EAClB,CAAC,EAGGvB,CACR,CACF,CACF,CCzMO,IAAMwB,CAAAA,CAAoE,CAChF,QAAA,CAAU,CAAE,KAAA,CAAO,GAAA,CAAK,MAAA,CAAQ,EAAG,EACnC,aAAA,CAAe,CAAE,KAAA,CAAO,GAAA,CAAM,MAAA,CAAQ,EAAI,EAC1C,aAAA,CAAe,CAAE,KAAA,CAAO,EAAA,CAAI,MAAA,CAAQ,EAAG,EACvC,SAAA,CAAW,CAAE,KAAA,CAAO,GAAA,CAAK,MAAA,CAAQ,GAAI,CACtC,EA0CO,SAASC,CAAAA,CAAmBvB,CAAAA,CAA2C,CAC7E,GAAM,CACL,MAAA,CAAAwB,CAAAA,CACA,KAAA,CAAAC,CAAAA,CAAQ,QAAA,CACR,SAAA,CAAAC,EACA,OAAA,CAAA9B,CAAAA,CAAU,2BAAA,CACV,KAAA,CAAOK,CAAAA,CAAU,UAAA,CAAW,MAC5B,SAAA,CAAA0B,CAAAA,CACA,KAAA,CAAAtB,CACD,CAAA,CAAIL,CAAAA,CAEJ,OAAAL,CAAAA,CAAgBC,CAAO,CAAA,CAEnB,OAAO,OAAA,CAAY,GAAA,EAAe,QAAQ,GAAA,EAAK,QAAA,GAAa,YAAA,EAAgB,CAAC4B,CAAAA,EAChF,OAAA,CAAQ,KAAK,uEAAuE,CAAA,CAG9EzB,CAAAA,CAAa,CACnB,KAAA,CAAOE,CAAAA,CACP,MAAAI,CAAAA,CACA,YAAA,CAAc,CAACG,CAAAA,CAAOoB,CAAAA,CAAQhB,CAAAA,IAAc,CAC3C,GAAA,CAAK,CAAA,EAAGhB,CAAO,CAAA,iBAAA,CAAA,CACf,IAAA,CAAM,CACL,OAAQ,MAAA,CACR,OAAA,CAAS,CACR,cAAA,CAAgB,kBAAA,CAChB,aAAA,CAAe,UAAU4B,CAAM,CAAA,CAChC,CAAA,CACA,IAAA,CAAM,IAAA,CAAK,SAAA,CAAU,CACpB,KAAA,CAAOhB,CAAAA,CAAM,KAAA,EAASiB,CAAAA,CACtB,GAAIC,CAAAA,EAAa,KAAO,CAAE,UAAA,CAAYA,CAAU,CAAA,CAAI,EAAC,CACrD,SAAU,CACT,GAAIlB,CAAAA,CAAM,YAAA,CACP,CAAC,CAAE,KAAM,QAAA,CAAU,OAAA,CAASA,CAAAA,CAAM,YAAa,CAAC,CAAA,CAChD,EAAC,CACJ,GAAGI,EAAS,GAAA,CAAKiB,CAAAA,GAAO,CAAE,IAAA,CAAMA,CAAAA,CAAE,IAAA,CAAM,OAAA,CAASA,CAAAA,CAAE,OAAQ,EAAE,CAC9D,CACD,CAAC,CAAA,CACD,GAAIF,CAAAA,EAAa,KAAO,CAAE,MAAA,CAAQ,WAAA,CAAY,OAAA,CAAQA,CAAS,CAAE,EAAI,EACtE,CACD,CAAA,CAAA,CACA,aAAA,CAAe,MAAOG,GAAQ,CAC7B,IAAMC,CAAAA,CAAO,MAAMD,CAAAA,CAAI,IAAA,GACjBvB,CAAAA,CAAOwB,CAAAA,CAAK,OAAA,GAAU,CAAC,CAAA,EAAG,OAAA,EAAS,SAAW,EAAA,CAC9CC,CAAAA,CAAcD,CAAAA,CAAK,KAAA,EAAO,aAAA,EAAiB,CAAA,CAC3CE,EAAeF,CAAAA,CAAK,KAAA,EAAO,iBAAA,EAAqB,CAAA,CAEtD,OAAO,CACN,KAAAxB,CAAAA,CACA,WAAA,CAAayB,CAAAA,CAAcC,CAAAA,CAC3B,WAAA,CAAAD,CAAAA,CACA,aAAAC,CACD,CACD,CACD,CAAC,CACF,CA0BO,SAASC,CAAAA,CACflC,CAAAA,CACa,CACb,GAAM,CACL,MAAA,CAAAwB,EACA,KAAA,CAAAC,CAAAA,CAAQ,wBAAA,CACR,UAAA,CAAAU,CAAAA,CAAa,IAAA,CACb,QAAAvC,CAAAA,CAAU,2BAAA,CACV,KAAA,CAAOK,CAAAA,CAAU,UAAA,CAAW,KAAA,CAC5B,UAAA0B,CACD,CAAA,CAAI3B,CAAAA,CAEJ,OAAAL,CAAAA,CAAgBC,CAAO,EAEnB,OAAO,OAAA,CAAY,GAAA,EAAe,OAAA,CAAQ,GAAA,EAAK,QAAA,GAAa,cAAgB,CAAC4B,CAAAA,EAChF,QAAQ,IAAA,CAAK,yEAAyE,EAGhF,MAAOjB,CAAAA,EAAqC,CAClD,IAAMQ,CAAAA,CAAW,MAAMd,EAAQ,CAAA,EAAGL,CAAO,CAAA,WAAA,CAAA,CAAe,CACvD,MAAA,CAAQ,MAAA,CACR,QAAS,CACR,cAAA,CAAgB,kBAAA,CAChB,aAAA,CAAe,CAAA,OAAA,EAAU4B,CAAM,EAChC,CAAA,CACA,IAAA,CAAM,IAAA,CAAK,SAAA,CAAU,CAAE,KAAA,CAAAC,EAAO,KAAA,CAAOlB,CAAAA,CAAM,UAAA,CAAA4B,CAAW,CAAC,CAAA,CACvD,OAAQ,WAAA,CAAY,OAAA,CAAQR,CAAAA,EAAa,GAAM,CAChD,CAAC,EAED,GAAI,CAACZ,CAAAA,CAAS,EAAA,CAAI,CACjB,IAAMC,EAAU,MAAMD,CAAAA,CAAS,IAAA,EAAK,CAAE,KAAA,CAAM,IAAM,EAAE,CAAA,CAEpD,MAAM,IAAI,KAAA,CACT,CAAA,qCAAA,EAAwCA,CAAAA,CAAS,MAAM,CAAA,EAAGC,CAAAA,CAAU,CAAA,QAAA,EAAMA,CAAAA,CAAQ,KAAA,CAAM,CAAA,CAAG,GAAG,CAAC,CAAA,CAAA,CAAK,EAAE,CAAA,CACvG,CACD,CAMA,IAAMoB,CAAAA,CAAAA,CAJQ,MAAMrB,CAAAA,CAAS,IAAA,EAAK,EAIf,IAAA,CAAK,CAAC,CAAA,CACzB,GAAI,CAACqB,CAAAA,CACJ,MAAM,IAAI,MACT,iEACD,CAAA,CAGD,OAAOA,CAAAA,CAAM,SACd,CACD,CAgCO,SAASC,CAAAA,CACfrC,CAAAA,CAC0B,CAC1B,GAAM,CACL,OAAAwB,CAAAA,CACA,KAAA,CAAAC,EAAQ,QAAA,CACR,SAAA,CAAAC,EACA,OAAA,CAAA9B,CAAAA,CAAU,2BAAA,CACV,KAAA,CAAOK,CAAAA,CAAU,UAAA,CAAW,MAC5B,KAAA,CAAAI,CACD,CAAA,CAAIL,CAAAA,CAEJ,OAAAL,CAAAA,CAAgBC,CAAO,CAAA,CAEnB,OAAO,OAAA,CAAY,GAAA,EAAe,OAAA,CAAQ,GAAA,EAAK,WAAa,YAAA,EAAgB,CAAC4B,CAAAA,EAChF,OAAA,CAAQ,IAAA,CAAK,gFAAgF,EAGvF,MAAOhB,CAAAA,CAAOC,CAAAA,CAAO6B,CAAAA,GAAc,CACzC,IAAM3B,EAAY,IAAA,CAAK,GAAA,EAAI,CAC3BN,CAAAA,EAAO,YAAA,GAAe,CAAE,MAAAG,CAAAA,CAAO,KAAA,CAAAC,CAAAA,CAAO,SAAA,CAAWE,CAAU,CAAC,EAE5D,GAAI,CACH,IAAMI,CAAAA,CAAW,MAAMd,CAAAA,CAAQ,GAAGL,CAAO,CAAA,iBAAA,CAAA,CAAqB,CAC7D,MAAA,CAAQ,MAAA,CACR,OAAA,CAAS,CACR,cAAA,CAAgB,kBAAA,CAChB,aAAA,CAAe,CAAA,OAAA,EAAU4B,CAAM,CAAA,CAChC,EACA,IAAA,CAAM,IAAA,CAAK,SAAA,CAAU,CACpB,KAAA,CAAOhB,CAAAA,CAAM,OAASiB,CAAAA,CACtB,GAAIC,CAAAA,EAAa,IAAA,CAAO,CAAE,UAAA,CAAYA,CAAU,CAAA,CAAI,EAAC,CACrD,QAAA,CAAU,CACT,GAAIlB,EAAM,YAAA,CACP,CAAC,CAAE,IAAA,CAAM,QAAA,CAAU,OAAA,CAASA,EAAM,YAAa,CAAC,CAAA,CAChD,EAAC,CACJ,CAAE,KAAM,MAAA,CAAQ,OAAA,CAASC,CAAM,CAChC,CAAA,CACA,MAAA,CAAQ,GACR,cAAA,CAAgB,CAAE,aAAA,CAAe,CAAA,CAAK,CACvC,CAAC,EACD,MAAA,CAAQ6B,CAAAA,CAAU,MACnB,CAAC,CAAA,CAED,GAAI,CAACvB,CAAAA,CAAS,EAAA,CAAI,CACjB,IAAMC,CAAAA,CAAU,MAAMD,EAAS,IAAA,EAAK,CAAE,KAAA,CAAM,IAAM,EAAE,CAAA,CAEpD,MAAM,IAAI,KAAA,CACT,CAAA,mCAAA,EAAsCA,CAAAA,CAAS,MAAM,CAAA,EAAGC,EAAU,CAAA,QAAA,EAAMA,CAAAA,CAAQ,KAAA,CAAM,CAAA,CAAG,GAAG,CAAC,GAAK,EAAE,CAAA,CACrG,CACD,CAEA,IAAMuB,CAAAA,CAASxB,EAAS,IAAA,EAAM,SAAA,EAAU,CACxC,GAAI,CAACwB,CAAAA,CACJ,MAAM,IAAI,KAAA,CAAM,8BAA8B,CAAA,CAG/C,IAAMC,CAAAA,CAAU,IAAI,WAAA,CAChBC,CAAAA,CAAM,EAAA,CACNC,CAAAA,CAAW,EAAA,CACXC,CAAAA,CAAe,EACfC,CAAAA,CAAmB,CAAA,CAEvB,GAAI,CACH,OAAa,CACZ,GAAM,CAAE,IAAA,CAAAC,CAAAA,CAAM,KAAA,CAAAC,CAAM,CAAA,CAAI,MAAMP,CAAAA,CAAO,IAAA,EAAK,CAC1C,GAAIM,CAAAA,CACH,MAGDJ,GAAOD,CAAAA,CAAQ,MAAA,CAAOM,CAAAA,CAAO,CAAE,MAAA,CAAQ,CAAA,CAAK,CAAC,CAAA,CAC7C,IAAMC,CAAAA,CAAQN,CAAAA,CAAI,KAAA,CAAM;AAAA,CAAI,CAAA,CAC5BA,EAAMM,CAAAA,CAAM,GAAA,IAAS,EAAA,CAErB,IAAA,IAAWC,KAAQD,CAAAA,CAAO,CACzB,GAAI,CAACC,CAAAA,CAAK,WAAW,QAAQ,CAAA,CAC5B,SAED,IAAMjB,CAAAA,CAAOiB,EAAK,KAAA,CAAM,CAAC,EAAE,IAAA,EAAK,CAChC,GAAIjB,CAAAA,GAAS,QAAA,CAIb,GAAI,CACH,IAAMkB,EAAQ,IAAA,CAAK,KAAA,CAAMlB,CAAI,CAAA,CAGvBmB,CAAAA,CAAQD,EAAM,OAAA,GAAU,CAAC,GAAG,KAAA,CAC9BC,CAAAA,EAAO,OAAA,GACVR,CAAAA,EAAYQ,CAAAA,CAAM,OAAA,CAClBZ,EAAU,OAAA,GAAUY,CAAAA,CAAM,OAAO,CAAA,CAAA,CAI9BD,CAAAA,CAAM,QACTN,CAAAA,CAAeM,CAAAA,CAAM,MAAM,aAAA,EAAiB,CAAA,CAC5CL,EAAmBK,CAAAA,CAAM,KAAA,CAAM,mBAAqB,CAAA,EAEtD,CAAA,MAASE,EAAU,CAClB,GAAIA,CAAAA,YAAoB,WAAA,CAEtB,OAAO,OAAA,CAAY,KACnB,OAAA,CAAQ,GAAA,EAAK,WAAa,aAAA,EAE1B,OAAA,CAAQ,KACP,8CAAA,CACApB,CACD,OAGD,MAAMoB,CAER,CACD,CACD,CACD,QAAE,CACDZ,CAAAA,CAAO,QAAO,CAAE,KAAA,CAAM,IAAM,CAAC,CAAC,EAC/B,CAEA,IAAMa,CAAAA,CAAwB,CAAE,IAAA,CAAM,WAAA,CAAa,QAASV,CAAS,CAAA,CACrEJ,EAAU,SAAA,GAAYc,CAAY,EAElC,IAAMlC,CAAAA,CAAyB,CAC9B,WAAA,CAAayB,CAAAA,CACb,aAAcC,CACf,CAAA,CACMS,CAAAA,CAAcV,CAAAA,CAAeC,CAAAA,CAEnC,OAAAvC,GAAO,WAAA,GAAc,CACpB,MAAAG,CAAAA,CACA,KAAA,CAAAC,EACA,MAAA,CAAQiC,CAAAA,CACR,YAAAW,CAAAA,CACA,UAAA,CAAAnC,EACA,UAAA,CAAY,IAAA,CAAK,KAAI,CAAIP,CAAAA,CACzB,UAAW,IAAA,CAAK,GAAA,EACjB,CAAC,CAAA,CAEM,CACN,OAAQ+B,CAAAA,CACR,QAAA,CAAU,CAAC,CAAE,IAAA,CAAM,OAAiB,OAAA,CAASjC,CAAM,EAAG2C,CAAY,CAAA,CAClE,UAAW,EAAC,CACZ,YAAAC,CAAAA,CACA,UAAA,CAAAnC,CACD,CACD,CAAA,MAASpB,CAAAA,CAAK,CACb,MAAIA,CAAAA,YAAe,OAClBO,CAAAA,EAAO,OAAA,GAAU,CAChB,KAAA,CAAAG,CAAAA,CACA,MAAAC,CAAAA,CACA,KAAA,CAAOX,EACP,UAAA,CAAY,IAAA,CAAK,KAAI,CAAIa,CAAAA,CACzB,UAAW,IAAA,CAAK,GAAA,EACjB,CAAC,CAAA,CAGIb,CACP,CACD,CACD","file":"openai.js","sourcesContent":["/**\n * Agent utilities — createRunner, estimateCost, state queries, URL validation.\n */\n\nimport type {\n  AdapterHooks,\n  AgentLike,\n  AgentRunner,\n  RunResult,\n  RunOptions,\n  Message,\n  TokenUsage,\n  AgentState,\n  ApprovalState,\n} from \"./types.js\";\n\n// ============================================================================\n// State Query Helpers\n// ============================================================================\n\n/** Check if agent is currently running. */\nexport function isAgentRunning(state: AgentState): boolean {\n  return state.status === \"running\";\n}\n\n/** Check if there are pending approvals. */\nexport function hasPendingApprovals(state: ApprovalState): boolean {\n  return state.pending.length > 0;\n}\n\n// ============================================================================\n// Cost Estimation\n// ============================================================================\n\n/**\n * Get total cost estimate based on token usage.\n *\n * @param tokenUsage - Total token count\n * @param ratePerMillionTokens - Cost per million tokens (required, no default to avoid stale pricing)\n * @returns Estimated cost in dollars\n */\nexport function estimateCost(\n  tokenUsage: number,\n  ratePerMillionTokens: number\n): number {\n  return (tokenUsage / 1_000_000) * ratePerMillionTokens;\n}\n\n// ============================================================================\n// Validation Helpers\n// ============================================================================\n\nconst ALLOWED_PROTOCOLS = new Set([\"http:\", \"https:\"]);\n\n/**\n * Validate that a baseURL uses http or https.\n * Throws immediately at adapter creation time (not at call time) to catch config errors early.\n */\nexport function validateBaseURL(baseURL: string): void {\n  try {\n    const url = new URL(baseURL);\n    if (!ALLOWED_PROTOCOLS.has(url.protocol)) {\n      throw new Error(\n        `[Directive] Invalid baseURL protocol \"${url.protocol}\" – only http: and https: are allowed`,\n      );\n    }\n  } catch (err) {\n    if (err instanceof Error && err.message.startsWith(\"[Directive]\")) {\n      throw err;\n    }\n\n    throw new Error(\n      `[Directive] Invalid baseURL \"${baseURL}\" – must be a valid URL (e.g. \"https://api.openai.com/v1\")`,\n    );\n  }\n}\n\n// ============================================================================\n// createRunner Helper\n// ============================================================================\n\n/** Parsed response from an LLM provider */\nexport interface ParsedResponse {\n  text: string;\n  totalTokens: number;\n  /** Input token count, when available from the provider */\n  inputTokens?: number;\n  /** Output token count, when available from the provider */\n  outputTokens?: number;\n}\n\n/** Options for creating an AgentRunner from buildRequest/parseResponse */\nexport interface CreateRunnerOptions {\n  fetch?: typeof globalThis.fetch;\n  buildRequest: (\n    agent: AgentLike,\n    input: string,\n    messages: Message[]\n  ) => { url: string; init: RequestInit };\n  parseResponse: (\n    response: Response,\n    messages: Message[]\n  ) => Promise<ParsedResponse>;\n  parseOutput?: <T>(text: string) => T;\n  /** Lifecycle hooks for tracing, logging, and metrics */\n  hooks?: AdapterHooks;\n}\n\n/**\n * Create an AgentRunner from buildRequest/parseResponse helpers.\n * Reduces ~50 lines of fetch boilerplate to ~20 lines of configuration.\n *\n * Supports lifecycle hooks for observability:\n * - `onBeforeCall` fires before each API request\n * - `onAfterCall` fires after a successful response (includes token breakdown)\n * - `onError` fires when the request fails\n *\n * @example\n * ```typescript\n * const runClaude = createRunner({\n *   buildRequest: (agent, input) => ({\n *     url: \"/api/claude\",\n *     init: {\n *       method: \"POST\",\n *       headers: { \"Content-Type\": \"application/json\" },\n *       body: JSON.stringify({\n *         model: agent.model ?? \"claude-haiku-4-5-20251001\",\n *         system: agent.instructions ?? \"\",\n *         messages: [{ role: \"user\", content: input }],\n *       }),\n *     },\n *   }),\n *   parseResponse: async (res) => {\n *     const data = await res.json();\n *     const inputTokens = data.usage?.input_tokens ?? 0;\n *     const outputTokens = data.usage?.output_tokens ?? 0;\n *     return {\n *       text: data.content?.[0]?.text ?? \"\",\n *       totalTokens: inputTokens + outputTokens,\n *       inputTokens,\n *       outputTokens,\n *     };\n *   },\n *   hooks: {\n *     onAfterCall: ({ durationMs, tokenUsage }) => {\n *       console.log(`LLM call: ${durationMs}ms, ${tokenUsage.inputTokens}in/${tokenUsage.outputTokens}out`);\n *     },\n *   },\n * });\n * ```\n */\nexport function createRunner(options: CreateRunnerOptions): AgentRunner {\n  const {\n    fetch: fetchFn = globalThis.fetch,\n    buildRequest,\n    parseResponse,\n    parseOutput,\n    hooks,\n  } = options;\n\n  const defaultParseOutput = <T>(text: string): T => {\n    try {\n      return JSON.parse(text) as T;\n    } catch {\n      return text as unknown as T;\n    }\n  };\n\n  const parse = parseOutput ?? defaultParseOutput;\n\n  return async <T = unknown>(\n    agent: AgentLike,\n    input: string,\n    runOptions?: RunOptions\n  ): Promise<RunResult<T>> => {\n    const startTime = Date.now();\n    hooks?.onBeforeCall?.({ agent, input, timestamp: startTime });\n\n    const messages: Message[] = [{ role: \"user\", content: input }];\n\n    try {\n      const { url, init } = buildRequest(agent, input, messages);\n\n      const fetchInit: RequestInit = runOptions?.signal\n        ? { ...init, signal: runOptions.signal }\n        : init;\n\n      const response = await fetchFn(url, fetchInit);\n\n      if (!response.ok) {\n        const errBody = await response.text().catch(() => \"\");\n\n        throw new Error(\n          `[Directive] AgentRunner request failed: ${response.status} ${response.statusText}${errBody ? ` – ${errBody.slice(0, 300)}` : \"\"}`,\n        );\n      }\n\n      const parsed = await parseResponse(response, messages);\n      const tokenUsage: TokenUsage = {\n        inputTokens: parsed.inputTokens ?? 0,\n        outputTokens: parsed.outputTokens ?? 0,\n      };\n\n      const assistantMessage: Message = { role: \"assistant\", content: parsed.text };\n      const allMessages: Message[] = [...messages, assistantMessage];\n\n      runOptions?.onMessage?.(assistantMessage);\n\n      const durationMs = Date.now() - startTime;\n      hooks?.onAfterCall?.({\n        agent,\n        input,\n        output: parsed.text,\n        totalTokens: parsed.totalTokens,\n        tokenUsage,\n        durationMs,\n        timestamp: Date.now(),\n      });\n\n      return {\n        output: parse<T>(parsed.text),\n        messages: allMessages,\n        toolCalls: [],\n        totalTokens: parsed.totalTokens,\n        tokenUsage,\n      };\n    } catch (err) {\n      const durationMs = Date.now() - startTime;\n      if (err instanceof Error) {\n        hooks?.onError?.({\n          agent,\n          input,\n          error: err,\n          durationMs,\n          timestamp: Date.now(),\n        });\n      }\n\n      throw err;\n    }\n  };\n}\n","/**\n * @directive-run/ai/openai\n *\n * OpenAI adapter for Directive AI. Provides runners and embedders\n * for OpenAI-compatible APIs (OpenAI, Azure, Together, etc.)\n *\n * @example\n * ```typescript\n * import { createOpenAIRunner, createOpenAIEmbedder } from '@directive-run/ai/openai';\n *\n * const runner = createOpenAIRunner({ apiKey: process.env.OPENAI_API_KEY! });\n * const embedder = createOpenAIEmbedder({ apiKey: process.env.OPENAI_API_KEY! });\n * ```\n */\n\nimport { createRunner, validateBaseURL } from \"../agent-utils.js\";\nimport type { AdapterHooks, AgentRunner, Message, TokenUsage } from \"../types.js\";\nimport type { StreamingCallbackRunner } from \"../types.js\";\nimport type { EmbedderFn, Embedding } from \"../guardrails/semantic-cache.js\";\n\n// ============================================================================\n// Pricing Constants\n// ============================================================================\n\n/**\n * OpenAI model pricing (USD per million tokens).\n *\n * Use with `estimateCost()` for per-call cost tracking:\n * ```typescript\n * import { estimateCost } from '@directive-run/ai';\n * import { OPENAI_PRICING } from '@directive-run/ai/openai';\n *\n * const cost =\n *   estimateCost(result.tokenUsage!.inputTokens, OPENAI_PRICING[\"gpt-4o\"].input) +\n *   estimateCost(result.tokenUsage!.outputTokens, OPENAI_PRICING[\"gpt-4o\"].output);\n * ```\n *\n * **Note:** Pricing changes over time. These values are provided as a convenience\n * and may not reflect the latest rates. Always verify at https://openai.com/pricing\n */\nexport const OPENAI_PRICING: Record<string, { input: number; output: number }> = {\n\t\"gpt-4o\": { input: 2.5, output: 10 },\n\t\"gpt-4o-mini\": { input: 0.15, output: 0.6 },\n\t\"gpt-4-turbo\": { input: 10, output: 30 },\n\t\"o3-mini\": { input: 1.1, output: 4.4 },\n};\n\n// ============================================================================\n// OpenAI Runner\n// ============================================================================\n\n/** Options for createOpenAIRunner */\nexport interface OpenAIRunnerOptions {\n\tapiKey: string;\n\tmodel?: string;\n\tmaxTokens?: number;\n\tbaseURL?: string;\n\tfetch?: typeof globalThis.fetch;\n\t/** @default undefined */\n\ttimeoutMs?: number;\n\t/** Lifecycle hooks for tracing, logging, and metrics */\n\thooks?: AdapterHooks;\n}\n\n/**\n * Create an AgentRunner for OpenAI-compatible APIs (OpenAI, Azure, Together, etc.)\n *\n * Returns `tokenUsage` with input/output breakdown for cost tracking.\n *\n * @example\n * ```typescript\n * // OpenAI\n * const runner = createOpenAIRunner({ apiKey: process.env.OPENAI_API_KEY! });\n *\n * // Azure OpenAI\n * const azure = createOpenAIRunner({\n *   apiKey: process.env.AZURE_KEY!,\n *   baseURL: \"https://your-resource.openai.azure.com/v1\",\n * });\n *\n * // Together.ai (OpenAI-compatible)\n * const together = createOpenAIRunner({\n *   apiKey: process.env.TOGETHER_KEY!,\n *   baseURL: \"https://api.together.xyz/v1\",\n * });\n * ```\n */\nexport function createOpenAIRunner(options: OpenAIRunnerOptions): AgentRunner {\n\tconst {\n\t\tapiKey,\n\t\tmodel = \"gpt-4o\",\n\t\tmaxTokens,\n\t\tbaseURL = \"https://api.openai.com/v1\",\n\t\tfetch: fetchFn = globalThis.fetch,\n\t\ttimeoutMs,\n\t\thooks,\n\t} = options;\n\n\tvalidateBaseURL(baseURL);\n\n\tif (typeof process !== \"undefined\" && process.env?.NODE_ENV !== \"production\" && !apiKey) {\n\t\tconsole.warn(\"[Directive] createOpenAIRunner: apiKey is empty. API calls will fail.\");\n\t}\n\n\treturn createRunner({\n\t\tfetch: fetchFn,\n\t\thooks,\n\t\tbuildRequest: (agent, _input, messages) => ({\n\t\t\turl: `${baseURL}/chat/completions`,\n\t\t\tinit: {\n\t\t\t\tmethod: \"POST\",\n\t\t\t\theaders: {\n\t\t\t\t\t\"Content-Type\": \"application/json\",\n\t\t\t\t\tAuthorization: `Bearer ${apiKey}`,\n\t\t\t\t},\n\t\t\t\tbody: JSON.stringify({\n\t\t\t\t\tmodel: agent.model ?? model,\n\t\t\t\t\t...(maxTokens != null ? { max_tokens: maxTokens } : {}),\n\t\t\t\t\tmessages: [\n\t\t\t\t\t\t...(agent.instructions\n\t\t\t\t\t\t\t? [{ role: \"system\", content: agent.instructions }]\n\t\t\t\t\t\t\t: []),\n\t\t\t\t\t\t...messages.map((m) => ({ role: m.role, content: m.content })),\n\t\t\t\t\t],\n\t\t\t\t}),\n\t\t\t\t...(timeoutMs != null ? { signal: AbortSignal.timeout(timeoutMs) } : {}),\n\t\t\t},\n\t\t}),\n\t\tparseResponse: async (res) => {\n\t\t\tconst data = await res.json();\n\t\t\tconst text = data.choices?.[0]?.message?.content ?? \"\";\n\t\t\tconst inputTokens = data.usage?.prompt_tokens ?? 0;\n\t\t\tconst outputTokens = data.usage?.completion_tokens ?? 0;\n\n\t\t\treturn {\n\t\t\t\ttext,\n\t\t\t\ttotalTokens: inputTokens + outputTokens,\n\t\t\t\tinputTokens,\n\t\t\t\toutputTokens,\n\t\t\t};\n\t\t},\n\t});\n}\n\n// ============================================================================\n// OpenAI Embedder\n// ============================================================================\n\n/** Options for createOpenAIEmbedder */\nexport interface OpenAIEmbedderOptions {\n\tapiKey: string;\n\tmodel?: string;\n\tdimensions?: number;\n\tbaseURL?: string;\n\tfetch?: typeof globalThis.fetch;\n\t/** @default 30000 */\n\ttimeoutMs?: number;\n}\n\n/**\n * Create an EmbedderFn that calls the OpenAI embeddings API.\n *\n * @example\n * ```typescript\n * const embedder = createOpenAIEmbedder({ apiKey: process.env.OPENAI_API_KEY! });\n * const embedding = await embedder('How do constraints work?');\n * ```\n */\nexport function createOpenAIEmbedder(\n\toptions: OpenAIEmbedderOptions,\n): EmbedderFn {\n\tconst {\n\t\tapiKey,\n\t\tmodel = \"text-embedding-3-small\",\n\t\tdimensions = 1536,\n\t\tbaseURL = \"https://api.openai.com/v1\",\n\t\tfetch: fetchFn = globalThis.fetch,\n\t\ttimeoutMs,\n\t} = options;\n\n\tvalidateBaseURL(baseURL);\n\n\tif (typeof process !== \"undefined\" && process.env?.NODE_ENV !== \"production\" && !apiKey) {\n\t\tconsole.warn(\"[Directive] createOpenAIEmbedder: apiKey is empty. API calls will fail.\");\n\t}\n\n\treturn async (text: string): Promise<Embedding> => {\n\t\tconst response = await fetchFn(`${baseURL}/embeddings`, {\n\t\t\tmethod: \"POST\",\n\t\t\theaders: {\n\t\t\t\t\"Content-Type\": \"application/json\",\n\t\t\t\tAuthorization: `Bearer ${apiKey}`,\n\t\t\t},\n\t\t\tbody: JSON.stringify({ model, input: text, dimensions }),\n\t\t\tsignal: AbortSignal.timeout(timeoutMs ?? 30_000),\n\t\t});\n\n\t\tif (!response.ok) {\n\t\t\tconst errBody = await response.text().catch(() => \"\");\n\n\t\t\tthrow new Error(\n\t\t\t\t`[Directive] OpenAI embedding failed: ${response.status}${errBody ? ` – ${errBody.slice(0, 200)}` : \"\"}`,\n\t\t\t);\n\t\t}\n\n\t\tconst data = (await response.json()) as {\n\t\t\tdata: Array<{ embedding: number[] }>;\n\t\t};\n\n\t\tconst entry = data.data[0];\n\t\tif (!entry) {\n\t\t\tthrow new Error(\n\t\t\t\t\"[Directive] OpenAI embedding response contained no data entries\",\n\t\t\t);\n\t\t}\n\n\t\treturn entry.embedding;\n\t};\n}\n\n// ============================================================================\n// OpenAI Streaming Runner\n// ============================================================================\n\n/** Options for createOpenAIStreamingRunner */\nexport interface OpenAIStreamingRunnerOptions {\n\tapiKey: string;\n\tmodel?: string;\n\tmaxTokens?: number;\n\tbaseURL?: string;\n\tfetch?: typeof globalThis.fetch;\n\t/** Lifecycle hooks for tracing, logging, and metrics */\n\thooks?: AdapterHooks;\n}\n\n/**\n * Create a StreamingCallbackRunner for OpenAI-compatible chat completions\n * with server-sent events. Can be used standalone or paired with `createOpenAIRunner`.\n *\n * Returns `tokenUsage` with input/output breakdown for cost tracking.\n *\n * @example\n * ```typescript\n * const streamingRunner = createOpenAIStreamingRunner({\n *   apiKey: process.env.OPENAI_API_KEY!,\n * });\n * const streamRunner = createStreamingRunner(streamingRunner);\n * const { stream, result } = streamRunner(agent, input);\n * ```\n */\nexport function createOpenAIStreamingRunner(\n\toptions: OpenAIStreamingRunnerOptions,\n): StreamingCallbackRunner {\n\tconst {\n\t\tapiKey,\n\t\tmodel = \"gpt-4o\",\n\t\tmaxTokens,\n\t\tbaseURL = \"https://api.openai.com/v1\",\n\t\tfetch: fetchFn = globalThis.fetch,\n\t\thooks,\n\t} = options;\n\n\tvalidateBaseURL(baseURL);\n\n\tif (typeof process !== \"undefined\" && process.env?.NODE_ENV !== \"production\" && !apiKey) {\n\t\tconsole.warn(\"[Directive] createOpenAIStreamingRunner: apiKey is empty. API calls will fail.\");\n\t}\n\n\treturn async (agent, input, callbacks) => {\n\t\tconst startTime = Date.now();\n\t\thooks?.onBeforeCall?.({ agent, input, timestamp: startTime });\n\n\t\ttry {\n\t\t\tconst response = await fetchFn(`${baseURL}/chat/completions`, {\n\t\t\t\tmethod: \"POST\",\n\t\t\t\theaders: {\n\t\t\t\t\t\"Content-Type\": \"application/json\",\n\t\t\t\t\tAuthorization: `Bearer ${apiKey}`,\n\t\t\t\t},\n\t\t\t\tbody: JSON.stringify({\n\t\t\t\t\tmodel: agent.model ?? model,\n\t\t\t\t\t...(maxTokens != null ? { max_tokens: maxTokens } : {}),\n\t\t\t\t\tmessages: [\n\t\t\t\t\t\t...(agent.instructions\n\t\t\t\t\t\t\t? [{ role: \"system\", content: agent.instructions }]\n\t\t\t\t\t\t\t: []),\n\t\t\t\t\t\t{ role: \"user\", content: input },\n\t\t\t\t\t],\n\t\t\t\t\tstream: true,\n\t\t\t\t\tstream_options: { include_usage: true },\n\t\t\t\t}),\n\t\t\t\tsignal: callbacks.signal,\n\t\t\t});\n\n\t\t\tif (!response.ok) {\n\t\t\t\tconst errBody = await response.text().catch(() => \"\");\n\n\t\t\t\tthrow new Error(\n\t\t\t\t\t`[Directive] OpenAI streaming error ${response.status}${errBody ? ` – ${errBody.slice(0, 200)}` : \"\"}`,\n\t\t\t\t);\n\t\t\t}\n\n\t\t\tconst reader = response.body?.getReader();\n\t\t\tif (!reader) {\n\t\t\t\tthrow new Error(\"[Directive] No response body\");\n\t\t\t}\n\n\t\t\tconst decoder = new TextDecoder();\n\t\t\tlet buf = \"\";\n\t\t\tlet fullText = \"\";\n\t\t\tlet promptTokens = 0;\n\t\t\tlet completionTokens = 0;\n\n\t\t\ttry {\n\t\t\t\twhile (true) {\n\t\t\t\t\tconst { done, value } = await reader.read();\n\t\t\t\t\tif (done) {\n\t\t\t\t\t\tbreak;\n\t\t\t\t\t}\n\n\t\t\t\t\tbuf += decoder.decode(value, { stream: true });\n\t\t\t\t\tconst lines = buf.split(\"\\n\");\n\t\t\t\t\tbuf = lines.pop() ?? \"\";\n\n\t\t\t\t\tfor (const line of lines) {\n\t\t\t\t\t\tif (!line.startsWith(\"data: \")) {\n\t\t\t\t\t\t\tcontinue;\n\t\t\t\t\t\t}\n\t\t\t\t\t\tconst data = line.slice(6).trim();\n\t\t\t\t\t\tif (data === \"[DONE]\") {\n\t\t\t\t\t\t\tcontinue;\n\t\t\t\t\t\t}\n\n\t\t\t\t\t\ttry {\n\t\t\t\t\t\t\tconst event = JSON.parse(data);\n\n\t\t\t\t\t\t\t// Extract token content from delta\n\t\t\t\t\t\t\tconst delta = event.choices?.[0]?.delta;\n\t\t\t\t\t\t\tif (delta?.content) {\n\t\t\t\t\t\t\t\tfullText += delta.content;\n\t\t\t\t\t\t\t\tcallbacks.onToken?.(delta.content);\n\t\t\t\t\t\t\t}\n\n\t\t\t\t\t\t\t// Extract usage from the final chunk (stream_options: include_usage)\n\t\t\t\t\t\t\tif (event.usage) {\n\t\t\t\t\t\t\t\tpromptTokens = event.usage.prompt_tokens ?? 0;\n\t\t\t\t\t\t\t\tcompletionTokens = event.usage.completion_tokens ?? 0;\n\t\t\t\t\t\t\t}\n\t\t\t\t\t\t} catch (parseErr) {\n\t\t\t\t\t\t\tif (parseErr instanceof SyntaxError) {\n\t\t\t\t\t\t\t\tif (\n\t\t\t\t\t\t\t\t\ttypeof process !== \"undefined\" &&\n\t\t\t\t\t\t\t\t\tprocess.env?.NODE_ENV === \"development\"\n\t\t\t\t\t\t\t\t) {\n\t\t\t\t\t\t\t\t\tconsole.warn(\n\t\t\t\t\t\t\t\t\t\t\"[Directive] Malformed SSE event from OpenAI:\",\n\t\t\t\t\t\t\t\t\t\tdata,\n\t\t\t\t\t\t\t\t\t);\n\t\t\t\t\t\t\t\t}\n\t\t\t\t\t\t\t} else {\n\t\t\t\t\t\t\t\tthrow parseErr;\n\t\t\t\t\t\t\t}\n\t\t\t\t\t\t}\n\t\t\t\t\t}\n\t\t\t\t}\n\t\t\t} finally {\n\t\t\t\treader.cancel().catch(() => {});\n\t\t\t}\n\n\t\t\tconst assistantMsg: Message = { role: \"assistant\", content: fullText };\n\t\t\tcallbacks.onMessage?.(assistantMsg);\n\n\t\t\tconst tokenUsage: TokenUsage = {\n\t\t\t\tinputTokens: promptTokens,\n\t\t\t\toutputTokens: completionTokens,\n\t\t\t};\n\t\t\tconst totalTokens = promptTokens + completionTokens;\n\n\t\t\thooks?.onAfterCall?.({\n\t\t\t\tagent,\n\t\t\t\tinput,\n\t\t\t\toutput: fullText,\n\t\t\t\ttotalTokens,\n\t\t\t\ttokenUsage,\n\t\t\t\tdurationMs: Date.now() - startTime,\n\t\t\t\ttimestamp: Date.now(),\n\t\t\t});\n\n\t\t\treturn {\n\t\t\t\toutput: fullText,\n\t\t\t\tmessages: [{ role: \"user\" as const, content: input }, assistantMsg],\n\t\t\t\ttoolCalls: [],\n\t\t\t\ttotalTokens,\n\t\t\t\ttokenUsage,\n\t\t\t};\n\t\t} catch (err) {\n\t\t\tif (err instanceof Error) {\n\t\t\t\thooks?.onError?.({\n\t\t\t\t\tagent,\n\t\t\t\t\tinput,\n\t\t\t\t\terror: err,\n\t\t\t\t\tdurationMs: Date.now() - startTime,\n\t\t\t\t\ttimestamp: Date.now(),\n\t\t\t\t});\n\t\t\t}\n\n\t\t\tthrow err;\n\t\t}\n\t};\n}\n"]}

package/dist/semantic-cache-F0psCRuz.d.cts

@@ -0,0 +1,271 @@
+/**
+ * Semantic Caching Guardrail
+ *
+ * Caches agent responses based on semantic similarity to reduce redundant LLM calls.
+ * Uses vector embeddings to find semantically similar previous queries.
+ *
+ * @example
+ * ```typescript
+ * import { createSemanticCacheGuardrail } from '@directive-run/ai';
+ *
+ * const cacheGuardrail = createSemanticCacheGuardrail({
+ *   embedder: async (text) => {
+ *     // Use your embedding model (OpenAI, local model, etc.)
+ *     return await getEmbedding(text);
+ *   },
+ *   similarityThreshold: 0.95,
+ *   maxCacheSize: 1000,
+ *   ttlMs: 3600000, // 1 hour
+ * });
+ *
+ * const orchestrator = createAgentOrchestrator({
+ *   guardrails: {
+ *     input: [cacheGuardrail],
+ *   },
+ *   runner: run,
+ * });
+ * ```
+ */
+/** Vector embedding (array of numbers) */
+type Embedding = number[];
+/** Function to generate embeddings for text */
+type EmbedderFn = (text: string) => Promise<Embedding>;
+/** Cached response entry */
+interface CacheEntry {
+    id: string;
+    query: string;
+    queryEmbedding: Embedding;
+    response: string;
+    metadata: Record<string, unknown>;
+    createdAt: number;
+    accessedAt: number;
+    accessCount: number;
+    agentName?: string;
+}
+/** Cache lookup result */
+interface CacheLookupResult {
+    hit: boolean;
+    entry?: CacheEntry;
+    similarity?: number;
+    latencyMs: number;
+}
+/** Semantic cache configuration */
+interface SemanticCacheConfig {
+    /** Function to generate embeddings */
+    embedder: EmbedderFn;
+    /** Similarity threshold (0.0 to 1.0) for cache hits */
+    similarityThreshold?: number;
+    /** Maximum number of entries to cache */
+    maxCacheSize?: number;
+    /** Time-to-live in milliseconds for cache entries */
+    ttlMs?: number;
+    /** Cache namespace for multi-tenant scenarios */
+    namespace?: string;
+    /** Custom storage backend (defaults to in-memory) */
+    storage?: SemanticCacheStorage;
+    /** Callback when cache hit occurs */
+    onHit?: (entry: CacheEntry, similarity: number) => void;
+    /** Callback when cache miss occurs */
+    onMiss?: (query: string) => void;
+    /** Callback when cache lookup encounters an error */
+    onError?: (error: Error) => void;
+    /** Whether to include agent name in cache key */
+    perAgent?: boolean;
+}
+/** Storage interface for cache backends */
+interface SemanticCacheStorage {
+    /** Get all entries for a namespace */
+    getEntries(namespace: string): Promise<CacheEntry[]>;
+    /** Add an entry to the cache */
+    addEntry(namespace: string, entry: CacheEntry): Promise<void>;
+    /** Update an entry (e.g., access count) */
+    updateEntry(namespace: string, id: string, updates: Partial<CacheEntry>): Promise<void>;
+    /** Remove an entry */
+    removeEntry(namespace: string, id: string): Promise<void>;
+    /** Clear all entries in a namespace */
+    clear(namespace: string): Promise<void>;
+}
+/** Semantic cache instance */
+interface SemanticCache {
+    /** Look up a query in the cache */
+    lookup(query: string, agentName?: string): Promise<CacheLookupResult>;
+    /** Store a response in the cache */
+    store(query: string, response: string, agentName?: string, metadata?: Record<string, unknown>): Promise<void>;
+    /** Invalidate cache entries matching a predicate */
+    invalidate(predicate: (entry: CacheEntry) => boolean): Promise<number>;
+    /** Clear all cache entries */
+    clear(): Promise<void>;
+    /** Get cache statistics */
+    getStats(): CacheStats;
+    /** Export cache entries (for persistence) */
+    export(): Promise<CacheEntry[]>;
+    /** Import cache entries (from persistence) */
+    import(entries: CacheEntry[]): Promise<void>;
+}
+/** Cache statistics */
+interface CacheStats {
+    totalEntries: number;
+    totalHits: number;
+    totalMisses: number;
+    hitRate: number;
+    avgSimilarityOnHit: number;
+    oldestEntry: number | null;
+    newestEntry: number | null;
+}
+/**
+ * Create an in-memory cache storage backend.
+ */
+declare function createInMemoryStorage(): SemanticCacheStorage;
+/**
+ * Create a semantic cache instance.
+ *
+ * @example
+ * ```typescript
+ * const cache = createSemanticCache({
+ *   embedder: async (text) => {
+ *     const response = await openai.embeddings.create({
+ *       model: 'text-embedding-3-small',
+ *       input: text,
+ *     });
+ *     return response.data[0].embedding;
+ *   },
+ *   similarityThreshold: 0.92,
+ *   maxCacheSize: 500,
+ *   ttlMs: 3600000, // 1 hour
+ * });
+ *
+ * // Check cache before calling agent
+ * const result = await cache.lookup(userQuery);
+ * if (result.hit) {
+ *   return result.entry!.response;
+ * }
+ *
+ * // Call agent and cache response
+ * const response = await runAgent(userQuery);
+ * await cache.store(userQuery, response);
+ * ```
+ */
+declare function createSemanticCache(config: SemanticCacheConfig): SemanticCache;
+/** Input guardrail data for semantic cache */
+interface SemanticCacheGuardrailData {
+    input: string;
+    agentName?: string;
+}
+/**
+ * Result of semantic cache guardrail.
+ *
+ * **Important semantics:**
+ * - `passed: false` + `cacheHit: true` = Short-circuit with cached response (not an error!)
+ * - `passed: true` + `cacheHit: false` = No cache hit, proceed with agent call
+ *
+ * The `passed: false` follows guardrail convention where "not passing" stops the flow,
+ * but in this case stopping is desirable (returning cached data is good).
+ */
+interface SemanticCacheGuardrailResult {
+    /**
+     * Whether to proceed with the agent call.
+     * `false` means short-circuit with cached response (this is good, not an error).
+     * `true` means no cache hit, proceed with agent.
+     */
+    passed: boolean;
+    /** Indicates whether this was a cache hit */
+    cacheHit: boolean;
+    /** Reason for the result */
+    reason?: string;
+    /** The cached response (only present on cache hit) */
+    cachedResponse?: string;
+    /** Similarity score (0-1) of the cache hit */
+    similarity?: number;
+}
+/**
+ * Create a semantic caching input guardrail.
+ *
+ * **How it works:**
+ * - On cache HIT: Returns `{ passed: false, cacheHit: true, cachedResponse: "..." }`
+ *   The orchestrator should detect `cacheHit: true` and return the cached response.
+ * - On cache MISS: Returns `{ passed: true, cacheHit: false }`
+ *   Proceed with normal agent execution.
+ *
+ * **Important:** `passed: false` with `cacheHit: true` is SUCCESS, not failure.
+ * The guardrail "short-circuits" the flow to return cached data efficiently.
+ *
+ * @example
+ * ```typescript
+ * const cacheGuardrail = createSemanticCacheGuardrail({
+ *   cache: mySemanticCache,
+ * });
+ *
+ * const orchestrator = createAgentOrchestrator({
+ *   guardrails: {
+ *     input: [
+ *       {
+ *         name: 'semantic-cache',
+ *         fn: cacheGuardrail,
+ *       },
+ *     ],
+ *   },
+ *   runner: run,
+ * });
+ *
+ * // In your orchestrator wrapper, check for cache hits:
+ * const guardrailResult = await cacheGuardrail({ input: userQuery });
+ * if (guardrailResult.cacheHit) {
+ *   return guardrailResult.cachedResponse; // Fast path!
+ * }
+ * // Otherwise proceed with agent call...
+ * ```
+ */
+declare function createSemanticCacheGuardrail(config: {
+    cache: SemanticCache;
+}): (data: SemanticCacheGuardrailData) => Promise<SemanticCacheGuardrailResult>;
+/**
+ * Create a simple hash-based "embedder" for testing.
+ * NOT suitable for production - use a real embedding model.
+ */
+declare function createTestEmbedder(dimensions?: number): EmbedderFn;
+/** Batched embedder instance with dispose capability */
+interface BatchedEmbedder {
+    /** Embed a single text (batched internally) */
+    embed: EmbedderFn;
+    /** Flush any pending batch immediately */
+    flush(): Promise<void>;
+    /** Dispose of the embedder, clearing timers and rejecting pending requests */
+    dispose(): void;
+}
+/**
+ * Create a batched embedder that groups multiple texts into single API calls.
+ *
+ * **BREAKING CHANGE:** Previously returned `EmbedderFn` directly. Now returns
+ * a `BatchedEmbedder` object with `embed`, `flush`, and `dispose` methods.
+ *
+ * To migrate: `const embed = createBatchedEmbedder(...)` becomes
+ * `const { embed } = createBatchedEmbedder(...)`.
+ *
+ * @example
+ * ```typescript
+ * const batchedEmbedder = createBatchedEmbedder({
+ *   batchSize: 20,
+ *   embedBatch: async (texts) => {
+ *     const response = await openai.embeddings.create({
+ *       model: 'text-embedding-3-small',
+ *       input: texts,
+ *     });
+ *     return response.data.map(d => d.embedding);
+ *   },
+ *   maxWaitMs: 50,
+ * });
+ *
+ * // Use the embedder
+ * const embedding = await batchedEmbedder.embed("Hello world");
+ *
+ * // Clean up when done
+ * batchedEmbedder.dispose();
+ * ```
+ */
+declare function createBatchedEmbedder(config: {
+    batchSize?: number;
+    embedBatch: (texts: string[]) => Promise<Embedding[]>;
+    maxWaitMs?: number;
+}): BatchedEmbedder;
+
+export { type BatchedEmbedder as B, type CacheEntry as C, type Embedding as E, type SemanticCache as S, type EmbedderFn as a, type CacheLookupResult as b, type CacheStats as c, type SemanticCacheConfig as d, type SemanticCacheStorage as e, createBatchedEmbedder as f, createInMemoryStorage as g, createSemanticCache as h, createSemanticCacheGuardrail as i, createTestEmbedder as j };