mirascope 2.0.0-alpha.0

package/dist/index.js

@@ -0,0 +1,324 @@
+import { totalTokens, toolCallStart, toolCallEnd, toolCallChunk, thoughtStart, thoughtEnd, thoughtChunk, textStart, textEnd, textChunk, resolveFormat, resetProviderRegistry, registerProvider, model, messages_exports, isZodLike, isWebSearchTool, isProviderTool, isOutputParser, isFormat, isContextTool, getProviderForModel, defineTool, defineOutputParser, defineFormat, defineContextTool, createUsage, createToolkit, createContextToolkit, WebSearchTool, Toolkit, ToolOutput, ToolNotFoundError, ToolExecutionError, ToolError, TimeoutError, TOOL_TYPE, TOOL_MODE_INSTRUCTIONS, StreamResponse, ServerError, RootResponse, ResponseValidationError, Response, RateLimitError, ProviderTool, ProviderError, PermissionError, ParseError, NotFoundError, NoRegisteredProviderError, Model, MissingAPIKeyError, MirascopeError, JSON_MODE_INSTRUCTIONS, Image, FinishReason, FeatureNotSupportedError, FORMAT_TOOL_NAME, Document, ContextToolkit, ContextStreamResponse, ContextResponse, ConnectionError, CONTEXT_TOOL_TYPE, BaseResponse, BadRequestError, AuthenticationError, Audio, APIError, promoteToMessages } from './chunk-A6ZCB7BU.js';
+import { __export, __require } from './chunk-NSBPE2FW.js';
+
+// src/llm/index.ts
+var llm_exports = {};
+__export(llm_exports, {
+  APIError: () => APIError,
+  Audio: () => Audio,
+  AuthenticationError: () => AuthenticationError,
+  BadRequestError: () => BadRequestError,
+  BaseResponse: () => BaseResponse,
+  CONTEXT_MARKER: () => CONTEXT_MARKER,
+  CONTEXT_TOOL_TYPE: () => CONTEXT_TOOL_TYPE,
+  ConnectionError: () => ConnectionError,
+  ContextResponse: () => ContextResponse,
+  ContextStreamResponse: () => ContextStreamResponse,
+  ContextToolkit: () => ContextToolkit,
+  Document: () => Document,
+  FORMAT_TOOL_NAME: () => FORMAT_TOOL_NAME,
+  FeatureNotSupportedError: () => FeatureNotSupportedError,
+  FinishReason: () => FinishReason,
+  Image: () => Image,
+  JSON_MODE_INSTRUCTIONS: () => JSON_MODE_INSTRUCTIONS,
+  KNOWN_PROVIDER_IDS: () => KNOWN_PROVIDER_IDS,
+  MirascopeError: () => MirascopeError,
+  MissingAPIKeyError: () => MissingAPIKeyError,
+  Model: () => Model,
+  NoRegisteredProviderError: () => NoRegisteredProviderError,
+  NotFoundError: () => NotFoundError,
+  ParseError: () => ParseError,
+  PermissionError: () => PermissionError,
+  ProviderError: () => ProviderError,
+  ProviderTool: () => ProviderTool,
+  RateLimitError: () => RateLimitError,
+  Response: () => Response,
+  ResponseValidationError: () => ResponseValidationError,
+  RootResponse: () => RootResponse,
+  ServerError: () => ServerError,
+  StreamResponse: () => StreamResponse,
+  TOOL_MODE_INSTRUCTIONS: () => TOOL_MODE_INSTRUCTIONS,
+  TOOL_TYPE: () => TOOL_TYPE,
+  TimeoutError: () => TimeoutError,
+  ToolError: () => ToolError,
+  ToolExecutionError: () => ToolExecutionError,
+  ToolNotFoundError: () => ToolNotFoundError,
+  ToolOutput: () => ToolOutput,
+  Toolkit: () => Toolkit,
+  WebSearchTool: () => WebSearchTool,
+  createContext: () => createContext,
+  createContextToolkit: () => createContextToolkit,
+  createToolkit: () => createToolkit,
+  createUsage: () => createUsage,
+  defineCall: () => defineCall,
+  defineContextTool: () => defineContextTool,
+  defineFormat: () => defineFormat,
+  defineOutputParser: () => defineOutputParser,
+  definePrompt: () => definePrompt,
+  defineTool: () => defineTool,
+  getProviderForModel: () => getProviderForModel,
+  isContext: () => isContext,
+  isContextTool: () => isContextTool,
+  isFormat: () => isFormat,
+  isOutputParser: () => isOutputParser,
+  isProviderTool: () => isProviderTool,
+  isWebSearchTool: () => isWebSearchTool,
+  isZodLike: () => isZodLike,
+  messages: () => messages_exports,
+  model: () => model,
+  modelFromContext: () => modelFromContext,
+  registerProvider: () => registerProvider,
+  resetProviderRegistry: () => resetProviderRegistry,
+  resolveFormat: () => resolveFormat,
+  textChunk: () => textChunk,
+  textEnd: () => textEnd,
+  textStart: () => textStart,
+  thoughtChunk: () => thoughtChunk,
+  thoughtEnd: () => thoughtEnd,
+  thoughtStart: () => thoughtStart,
+  toolCallChunk: () => toolCallChunk,
+  toolCallEnd: () => toolCallEnd,
+  toolCallStart: () => toolCallStart,
+  totalTokens: () => totalTokens,
+  useModel: () => useModel,
+  withModel: () => withModel
+});
+
+// src/llm/providers/provider-id.ts
+var KNOWN_PROVIDER_IDS = [
+  "anthropic",
+  "google",
+  "mirascope",
+  "ollama",
+  "openai",
+  "together"
+];
+
+// src/llm/context/context.ts
+var CONTEXT_MARKER = /* @__PURE__ */ Symbol("mirascope.Context");
+function isContext(value) {
+  return value !== null && typeof value === "object" && CONTEXT_MARKER in value;
+}
+function createContext(deps) {
+  return { [CONTEXT_MARKER]: true, deps };
+}
+
+// src/llm/models/model-context.ts
+function createNodeStorage() {
+  const { AsyncLocalStorage } = __require("async_hooks");
+  const storage = new AsyncLocalStorage();
+  return {
+    get: () => storage.getStore(),
+    run: (value, fn) => storage.run(value, fn)
+  };
+}
+function createBrowserStorage() {
+  const stack = [];
+  return {
+    get: () => stack[stack.length - 1],
+    run: (value, fn) => {
+      stack.push(value);
+      try {
+        const result = fn();
+        if (result instanceof Promise) {
+          return result.finally(() => {
+            stack.pop();
+          });
+        }
+        stack.pop();
+        return result;
+      } catch (e) {
+        stack.pop();
+        throw e;
+      }
+    }
+  };
+}
+function createStorage() {
+  try {
+    return createNodeStorage();
+  } catch {
+    return createBrowserStorage();
+  }
+}
+var modelStorage = createStorage();
+function modelFromContext() {
+  return modelStorage.get();
+}
+function withModel(modelOrId, paramsOrFn, fn) {
+  let resolvedModel;
+  let resolvedFn;
+  if (typeof modelOrId === "string") {
+    if (typeof paramsOrFn === "function") {
+      resolvedModel = new Model(modelOrId);
+      resolvedFn = paramsOrFn;
+    } else {
+      resolvedModel = new Model(modelOrId, paramsOrFn);
+      resolvedFn = fn;
+    }
+  } else {
+    resolvedModel = modelOrId;
+    resolvedFn = paramsOrFn;
+  }
+  return modelStorage.run(resolvedModel, resolvedFn);
+}
+function useModel(model2, params) {
+  const contextModel = modelFromContext();
+  if (contextModel !== void 0) {
+    return contextModel;
+  }
+  if (typeof model2 === "string") {
+    return new Model(model2, params);
+  }
+  return model2;
+}
+
+// src/llm/prompts/prompt.ts
+function definePrompt({
+  tools,
+  format,
+  template
+}) {
+  const resolvedFormat = resolveFormat(format, "tool");
+  const messagesImpl = (...args) => {
+    const firstArg = args[0];
+    if (isContext(firstArg)) {
+      const ctx = firstArg;
+      const vars = args[1];
+      const templateArgs = { ctx, ...vars };
+      const content = template.length === 0 ? template() : template(
+        templateArgs
+      );
+      return promoteToMessages(content);
+    } else {
+      const vars = firstArg;
+      const content = template.length === 0 ? template() : template(
+        vars
+      );
+      return promoteToMessages(content);
+    }
+  };
+  const callImpl = async (...args) => {
+    const modelArg = args[0];
+    const secondArg = args[1];
+    if (isContext(secondArg)) {
+      const ctx = secondArg;
+      const vars = args[2];
+      const msgs = messagesImpl(ctx, vars);
+      return useModel(modelArg).contextCall(ctx, msgs, {
+        tools,
+        format: resolvedFormat
+      });
+    } else {
+      const vars = secondArg;
+      const msgs = messagesImpl(vars);
+      return useModel(modelArg).call(msgs, {
+        tools,
+        format: resolvedFormat
+      });
+    }
+  };
+  const callable = async (...args) => {
+    return callImpl(...args);
+  };
+  const streamImpl = async (...args) => {
+    const modelArg = args[0];
+    const secondArg = args[1];
+    if (isContext(secondArg)) {
+      const ctx = secondArg;
+      const vars = args[2];
+      const msgs = messagesImpl(ctx, vars);
+      return useModel(modelArg).contextStream(ctx, msgs, {
+        tools,
+        format: resolvedFormat
+      });
+    } else {
+      const vars = secondArg;
+      const msgs = messagesImpl(vars);
+      return useModel(modelArg).stream(msgs, {
+        tools,
+        format: resolvedFormat
+      });
+    }
+  };
+  return Object.assign(callable, {
+    call: callImpl,
+    stream: streamImpl,
+    messages: messagesImpl,
+    tools,
+    format,
+    template
+  });
+}
+
+// src/llm/calls/call.ts
+function createCall({
+  model: model2,
+  tools,
+  format,
+  template,
+  ...params
+}) {
+  if (typeof model2 !== "string" && Object.keys(params).length > 0) {
+    throw new Error(
+      "Cannot pass params when model is a Model instance. Use new Model(id, params) instead."
+    );
+  }
+  const defaultModel = typeof model2 === "string" ? new Model(model2, params) : model2;
+  const prompt = definePrompt({ tools, format, template });
+  const callImpl = async (...args) => {
+    const firstArg = args[0];
+    if (isContext(firstArg)) {
+      const ctx = firstArg;
+      const vars = args[1];
+      const contextPrompt = prompt;
+      return contextPrompt.call(useModel(defaultModel), ctx, vars);
+    } else {
+      const vars = firstArg;
+      const regularPrompt = prompt;
+      return regularPrompt.call(useModel(defaultModel), vars);
+    }
+  };
+  const callable = async (...args) => {
+    return callImpl(...args);
+  };
+  const streamImpl = async (...args) => {
+    const firstArg = args[0];
+    if (isContext(firstArg)) {
+      const ctx = firstArg;
+      const vars = args[1];
+      const contextPrompt = prompt;
+      return contextPrompt.stream(useModel(defaultModel), ctx, vars);
+    } else {
+      const vars = firstArg;
+      const regularPrompt = prompt;
+      return regularPrompt.stream(useModel(defaultModel), vars);
+    }
+  };
+  const definedCall = Object.assign(callable, {
+    defaultModel,
+    call: callImpl,
+    stream: streamImpl,
+    tools,
+    format,
+    prompt,
+    template
+  });
+  Object.defineProperty(definedCall, "model", {
+    get: () => useModel(defaultModel),
+    enumerable: true
+  });
+  return definedCall;
+}
+function defineCall(args) {
+  if (args === void 0) {
+    return ((builderArgs) => {
+      return createCall(builderArgs);
+    });
+  }
+  return createCall(args);
+}
+
+export { llm_exports as llm };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/llm/index.ts","../src/llm/providers/provider-id.ts","../src/llm/context/context.ts","../src/llm/models/model-context.ts","../src/llm/prompts/prompt.ts","../src/llm/calls/call.ts"],"names":["model"],"mappings":"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","file":"index.js","sourcesContent":["export type { Jsonable } from \"@/llm/types\";\n\nexport type {\n  AnthropicModelId,\n  GoogleModelId,\n  OpenAIModelId,\n  ApiMode,\n  KnownProviderId,\n  ModelId,\n  Provider,\n  ProviderId,\n} from \"@/llm/providers\";\nexport { KNOWN_PROVIDER_IDS } from \"@/llm/providers\";\n\nexport {\n  type Context,\n  createContext,\n  isContext,\n  CONTEXT_MARKER,\n} from \"@/llm/context\";\n\nexport type {\n  AssistantContentPart,\n  AssistantContentChunk,\n  ContentPart,\n  UserContentPart,\n} from \"@/llm/content\";\n\nexport type { Text, Thought, ToolCall } from \"@/llm/content\";\n\n// Content chunk types (from content module, like Python)\nexport type {\n  TextStartChunk,\n  TextChunk,\n  TextEndChunk,\n  ThoughtStartChunk,\n  ThoughtChunk,\n  ThoughtEndChunk,\n  ToolCallStartChunk,\n  ToolCallChunk,\n  ToolCallEndChunk,\n} from \"@/llm/content\";\n\n// Content chunk factory functions\nexport {\n  textStart,\n  textChunk,\n  textEnd,\n  thoughtStart,\n  thoughtChunk,\n  thoughtEnd,\n  toolCallStart,\n  toolCallChunk,\n  toolCallEnd,\n} from \"@/llm/content\";\n\nexport {\n  Audio,\n  type AudioMimeType,\n  type Base64AudioSource,\n} from \"@/llm/content\";\n\nexport {\n  Document,\n  type Base64DocumentSource,\n  type DocumentBase64MimeType,\n  type DocumentTextMimeType,\n  type TextDocumentSource,\n  type URLDocumentSource,\n} from \"@/llm/content\";\n\nexport {\n  Image,\n  type Base64ImageSource,\n  type ImageMimeType,\n  type URLImageSource,\n} from \"@/llm/content\";\n\nexport { ToolOutput } from \"@/llm/content\";\n\nexport {\n  defineTool,\n  defineContextTool,\n  isZodLike,\n  isContextTool,\n  Toolkit,\n  ContextToolkit,\n  createToolkit,\n  createContextToolkit,\n  TOOL_TYPE,\n  CONTEXT_TOOL_TYPE,\n  ProviderTool,\n  isProviderTool,\n  WebSearchTool,\n  isWebSearchTool,\n} from \"@/llm/tools\";\n\nexport type {\n  JsonSchemaProperty,\n  ToolParameterSchema,\n  ToolSchema,\n  ZodLike,\n  InferZod,\n  ToolArgs,\n  ContextToolArgs,\n  ZodToolArgs,\n  ZodContextToolArgs,\n  BaseTool,\n  BaseContextTool,\n  Tool,\n  ContextTool,\n  AnyTool,\n  AnyContextTool,\n  Tools,\n  ContextTools,\n  ToolFn,\n  ContextToolFn,\n  AnyToolFn,\n} from \"@/llm/tools\";\n\nexport type {\n  AssistantContent,\n  AssistantMessage,\n  Message,\n  SystemContent,\n  SystemMessage,\n  UserContent,\n  UserMessage,\n} from \"@/llm/messages\";\n\nimport * as messages from \"@/llm/messages\";\nexport { messages };\n\nexport {\n  MirascopeError,\n  ProviderError,\n  APIError,\n  AuthenticationError,\n  PermissionError,\n  BadRequestError,\n  NotFoundError,\n  RateLimitError,\n  ServerError,\n  ConnectionError,\n  TimeoutError,\n  ResponseValidationError,\n  ToolError,\n  ToolExecutionError,\n  ToolNotFoundError,\n  ParseError,\n  FeatureNotSupportedError,\n  NoRegisteredProviderError,\n  MissingAPIKeyError,\n} from \"@/llm/exceptions\";\n\nexport type { Params, ThinkingConfig, ThinkingLevel } from \"@/llm/models\";\n\nexport {\n  defineFormat,\n  defineOutputParser,\n  isFormat,\n  isOutputParser,\n  resolveFormat,\n  FORMAT_TOOL_NAME,\n  TOOL_MODE_INSTRUCTIONS,\n  JSON_MODE_INSTRUCTIONS,\n} from \"@/llm/formatting\";\n\nexport type {\n  Format,\n  FormatSpec,\n  FormattingMode,\n  OutputParser,\n  OutputParserArgs,\n  DeepPartial,\n} from \"@/llm/formatting\";\nexport {\n  Model,\n  model,\n  modelFromContext,\n  useModel,\n  withModel,\n} from \"@/llm/models\";\n\nexport {\n  definePrompt,\n  type MessageTemplate,\n  type Prompt,\n  type PromptArgs,\n  type TemplateFunc,\n  // Context-aware types (unified API)\n  type ContextMessageTemplate,\n  type ContextPrompt,\n  type ContextPromptArgs,\n  type ContextTemplateFunc,\n  // Type utilities\n  type ExtractDeps,\n  type ExtractVars,\n  type UnifiedPrompt,\n} from \"@/llm/prompts\";\n\nexport {\n  defineCall,\n  type Call,\n  type CallArgs,\n  // Context-aware types (unified API)\n  type ContextCall,\n  type ContextCallArgs,\n  // Type utilities\n  type UnifiedCall,\n} from \"@/llm/calls\";\n\nexport {\n  getProviderForModel,\n  registerProvider,\n  resetProviderRegistry,\n} from \"@/llm/providers\";\n\nexport {\n  FinishReason,\n  RootResponse,\n  BaseResponse,\n  Response,\n  ContextResponse,\n  StreamResponse,\n  ContextStreamResponse,\n  createUsage,\n  totalTokens,\n} from \"@/llm/responses\";\nexport type { AnyResponse } from \"@/llm/responses\";\nexport type {\n  FinishReasonType,\n  Usage,\n  BaseResponseInit,\n  ResponseInit,\n  ContextResponseInit,\n  StreamResponseInit,\n  ContextStreamResponseInit,\n  // Metadata streaming chunk types (content chunks exported from content above)\n  FinishReasonChunk,\n  UsageDeltaChunk,\n  RawStreamEventChunk,\n  RawMessageChunk,\n  StreamResponseChunk,\n  AsyncChunkIterator,\n} from \"@/llm/responses\";\n","/**\n * Identifiers for all registered providers.\n */\n\n/**\n * Array of known provider IDs for runtime checks.\n */\nexport const KNOWN_PROVIDER_IDS = [\n  \"anthropic\",\n  \"google\",\n  \"mirascope\",\n  \"ollama\",\n  \"openai\",\n  \"together\",\n] as const;\n\n/**\n * Known provider identifiers.\n */\nexport type KnownProviderId = (typeof KNOWN_PROVIDER_IDS)[number];\n\n/**\n * Provider identifier.\n *\n * Can be a known provider or any custom string for extensibility.\n */\nexport type ProviderId = KnownProviderId | (string & {});\n","/**\n * Context for LLM calls with dependency injection.\n *\n * Context allows you to pass dependencies (like database connections, user info,\n * configuration, etc.) through to your prompts and tools in a type-safe way.\n */\n\n/**\n * Symbol marker used to identify Context objects at runtime.\n * This enables reliable detection of Context instances in unified call/prompt functions.\n */\nexport const CONTEXT_MARKER = Symbol(\"mirascope.Context\");\n\n/**\n * Context for LLM calls with dependency injection.\n *\n * @template DepsT - The type of dependencies contained in the context.\n *\n * @example\n * ```typescript\n * interface MyDeps {\n *   userId: string;\n *   db: Database;\n * }\n *\n * const ctx = createContext<MyDeps>({ userId: '123', db: myDb });\n * const response = await myPrompt(model, ctx, { greeting: 'Hello' });\n * ```\n */\nexport interface Context<DepsT> {\n  /**\n   * Marker property for runtime Context detection.\n   * @internal\n   */\n  readonly [CONTEXT_MARKER]: true;\n\n  /**\n   * The dependencies available in this context.\n   */\n  readonly deps: DepsT;\n}\n\n/**\n * Type guard to check if a value is a Context object.\n *\n * @param value - The value to check.\n * @returns True if the value is a Context, false otherwise.\n *\n * @example\n * ```typescript\n * const maybeCtx = getArgument();\n * if (isContext(maybeCtx)) {\n *   console.log(maybeCtx.deps); // TypeScript knows this is a Context\n * }\n * ```\n */\nexport function isContext(value: unknown): value is Context<unknown> {\n  return value !== null && typeof value === \"object\" && CONTEXT_MARKER in value;\n}\n\n/**\n * Create a context with the given dependencies.\n *\n * @template DepsT - The type of dependencies.\n * @param deps - The dependencies to include in the context.\n * @returns A Context containing the provided dependencies.\n *\n * @example\n * ```typescript\n * interface MyDeps {\n *   userId: string;\n *   db: Database;\n * }\n *\n * const ctx = createContext<MyDeps>({ userId: '123', db: myDb });\n * ```\n */\nexport function createContext<DepsT>(deps: DepsT): Context<DepsT> {\n  return { [CONTEXT_MARKER]: true as const, deps };\n}\n","/**\n * Model context management for runtime model switching.\n *\n * This module provides a way to set a model context that overrides\n * the default model in `defineCall` and `definePrompt`, similar to\n * Python's `with llm.model(...):` context manager.\n *\n * ## Cross-Platform Implementation\n *\n * - **Node.js**: Uses native `AsyncLocalStorage` from `async_hooks` for proper\n *   async context propagation. This handles concurrent async operations correctly.\n *\n * - **Browser**: Uses a stack-based fallback. This works correctly for:\n *   - Synchronous code\n *   - Sequential async/await chains\n *   - Nested `withModel` calls (as long as they are sequential)\n *\n * ## Browser Limitations\n *\n * The browser fallback has a known limitation with **concurrent** async operations:\n *\n * ```typescript\n * // WARNING: In browsers, this may have unexpected behavior:\n * await Promise.all([\n *   llm.withModel(modelA, async () => { await call(); }), // May see modelB!\n *   llm.withModel(modelB, async () => { await call(); }), // May see modelA!\n * ]);\n * ```\n *\n * This is because the browser lacks a native async context mechanism. The stack\n * can become interleaved when multiple async operations run concurrently.\n *\n * ## Future: TC39 AsyncContext Proposal\n *\n * The TC39 \"Async Context\" proposal (https://github.com/tc39/proposal-async-context)\n * aims to bring `AsyncLocalStorage`-like functionality to all JavaScript environments.\n * Once this proposal is standardized and widely supported, we can update the browser\n * implementation to use native async context, eliminating the concurrent operation\n * limitation.\n *\n * @see https://github.com/tc39/proposal-async-context\n *\n * @example\n * ```typescript\n * const call = llm.defineCall({\n *   model: llm.model(\"openai/gpt-4o\"),\n *   template: () => \"Hello\"\n * });\n *\n * // Without context - uses default model\n * await call();\n *\n * // With context - overrides default\n * await llm.withModel(llm.model(\"anthropic/claude-sonnet-4-0\"), async () => {\n *   await call(); // Uses Claude\n * });\n * ```\n */\n\nimport type { Params } from \"@/llm/models/params\";\nimport type { ModelId } from \"@/llm/providers/model-id\";\n\nimport { Model } from \"@/llm/models/model\";\n\n/**\n * Cross-platform context storage interface.\n * Abstracts over Node.js AsyncLocalStorage and browser fallback.\n * @internal Exported for testing purposes only\n */\nexport interface ContextStorage<T> {\n  get(): T | undefined;\n  run<R>(value: T, fn: () => R): R;\n}\n\n/**\n * Node.js implementation using AsyncLocalStorage.\n * Provides proper async context propagation across async/await boundaries.\n */\nfunction createNodeStorage<T>(): ContextStorage<T> {\n  // Dynamic require to avoid issues in browser bundlers\n  // eslint-disable-next-line @typescript-eslint/no-require-imports\n  const { AsyncLocalStorage } = require(\"node:async_hooks\") as {\n    AsyncLocalStorage: new <T>() => {\n      getStore(): T | undefined;\n      run<R>(store: T, callback: () => R): R;\n    };\n  };\n  const storage = new AsyncLocalStorage<T>();\n  return {\n    get: () => storage.getStore(),\n    run: <R>(value: T, fn: () => R): R => storage.run(value, fn),\n  };\n}\n\n/**\n * Browser fallback using a stack.\n *\n * **Limitations**: This implementation works correctly for sequential async operations\n * but does NOT properly isolate concurrent async operations. When multiple `withModel`\n * calls run in parallel via `Promise.all`, their contexts may become interleaved.\n *\n * This is a fundamental limitation of any JavaScript-based solution without native\n * async context support. The TC39 AsyncContext proposal will solve this when available.\n *\n * @see https://github.com/tc39/proposal-async-context\n * @internal Exported for testing purposes only\n */\nexport function createBrowserStorage<T>(): ContextStorage<T> {\n  const stack: T[] = [];\n  return {\n    get: () => stack[stack.length - 1],\n    run: <R>(value: T, fn: () => R): R => {\n      stack.push(value);\n      try {\n        const result = fn();\n        // Handle promises to ensure cleanup after async completion\n        if (result instanceof Promise) {\n          return result.finally(() => {\n            stack.pop();\n          }) as R;\n        }\n        stack.pop();\n        return result;\n      } catch (e) {\n        stack.pop();\n        throw e;\n      }\n    },\n  };\n}\n\n/**\n * Auto-detect environment and create appropriate storage.\n * @internal Exported for testing purposes only\n */\nexport function createStorage<T>(): ContextStorage<T> {\n  try {\n    return createNodeStorage<T>();\n    /* v8 ignore start - browser fallback only hit when AsyncLocalStorage unavailable */\n  } catch {\n    // This branch is only hit in browser environments where AsyncLocalStorage\n    // is unavailable. Since tests run in Node.js, this is tested indirectly\n    // through createBrowserStorage tests.\n    return createBrowserStorage<T>();\n  }\n  /* v8 ignore stop */\n}\n\n// Initialize the model storage\nconst modelStorage = createStorage<Model>();\n\n/**\n * Get the model currently set via context, if any.\n *\n * @returns The current context model, or undefined if none is set.\n *\n * @example\n * ```typescript\n * await llm.withModel(llm.model(\"anthropic/claude-sonnet-4-0\"), async () => {\n *   const model = llm.modelFromContext();\n *   console.log(model?.modelId); // \"anthropic/claude-sonnet-4-0\"\n * });\n *\n * const outsideModel = llm.modelFromContext(); // undefined\n * ```\n */\nexport function modelFromContext(): Model | undefined {\n  return modelStorage.get();\n}\n\n/**\n * Execute a function with a model set in context.\n *\n * All calls to `defineCall` and `definePrompt` within the callback\n * will use the context model instead of their default model.\n *\n * @param model - The model to set in context (Model instance or model ID string).\n * @param paramsOrFn - Either params object (if using string model ID) or the function to execute.\n * @param fn - The function to execute (if params were provided).\n * @returns The return value of the function.\n *\n * @example With Model instance\n * ```typescript\n * const response = await llm.withModel(llm.model(\"openai/gpt-4o\"), async () => {\n *   return await call();\n * });\n * ```\n *\n * @example With model ID string\n * ```typescript\n * const response = await llm.withModel(\"openai/gpt-4o\", async () => {\n *   return await call();\n * });\n * ```\n *\n * @example With model ID and params\n * ```typescript\n * const response = await llm.withModel(\"anthropic/claude-sonnet-4-0\", { temperature: 0.9 }, async () => {\n *   return await call();\n * });\n * ```\n *\n * @example Nested contexts\n * ```typescript\n * await llm.withModel(\"anthropic/claude-sonnet-4-0\", async () => {\n *   const model1 = llm.modelFromContext(); // Claude\n *\n *   await llm.withModel(\"openai/gpt-4o\", async () => {\n *     const model2 = llm.modelFromContext(); // GPT-4o\n *   });\n *\n *   const model3 = llm.modelFromContext(); // Claude (restored)\n * });\n * ```\n */\nexport function withModel<T>(model: Model, fn: () => T): T;\nexport function withModel<T>(modelId: ModelId, fn: () => T): T;\nexport function withModel<T>(modelId: ModelId, params: Params, fn: () => T): T;\nexport function withModel<T>(\n  modelOrId: Model | ModelId,\n  paramsOrFn: Params | (() => T),\n  fn?: () => T,\n): T {\n  let resolvedModel: Model;\n  let resolvedFn: () => T;\n\n  if (typeof modelOrId === \"string\") {\n    // String model ID\n    if (typeof paramsOrFn === \"function\") {\n      // withModel(modelId, fn)\n      resolvedModel = new Model(modelOrId);\n      resolvedFn = paramsOrFn;\n    } else {\n      // withModel(modelId, params, fn)\n      resolvedModel = new Model(modelOrId, paramsOrFn);\n      resolvedFn = fn!;\n    }\n  } else {\n    // Model instance\n    resolvedModel = modelOrId;\n    resolvedFn = paramsOrFn as () => T;\n  }\n\n  return modelStorage.run(resolvedModel, resolvedFn);\n}\n\n/**\n * Get the model from context if available, otherwise use the provided model.\n *\n * This function implements the fallback pattern:\n * 1. If a model is set in context, return it (context takes precedence)\n * 2. Otherwise, if a Model instance is provided, return it\n * 3. Otherwise, if a string model ID is provided, create a new Model\n *\n * @param modelOrId - A Model instance or model ID string.\n * @param params - Optional parameters when creating a new Model from string ID.\n * @returns The resolved Model instance.\n *\n * @example\n * ```typescript\n * // Outside context - returns the provided model\n * const model1 = llm.useModel(\"openai/gpt-4o\"); // Creates new Model\n *\n * // Inside context - returns context model\n * await llm.withModel(llm.model(\"anthropic/claude-sonnet-4-0\"), async () => {\n *   const model2 = llm.useModel(\"openai/gpt-4o\"); // Returns Claude model\n * });\n * ```\n */\nexport function useModel(model: Model | ModelId, params?: Params): Model {\n  const contextModel = modelFromContext();\n  if (contextModel !== undefined) {\n    return contextModel;\n  }\n  if (typeof model === \"string\") {\n    return new Model(model, params);\n  }\n  return model;\n}\n","/**\n * Prompt definition and creation utilities.\n *\n * This module provides a unified `definePrompt` function that automatically\n * detects whether a prompt is context-aware based on the template type parameter.\n * If T includes `ctx: Context<DepsT>`, a ContextPrompt is returned; otherwise\n * a regular Prompt is returned.\n */\n\nimport type { Message, UserContent } from \"@/llm/messages\";\nimport type { ModelId } from \"@/llm/providers/model-id\";\nimport type { Response } from \"@/llm/responses\";\nimport type { StreamResponse } from \"@/llm/responses/stream-response\";\nimport type { ContextTools, Tools, ZodLike } from \"@/llm/tools\";\nimport type { NoVars } from \"@/llm/types\";\n\nimport { type Context, isContext } from \"@/llm/context\";\nimport {\n  resolveFormat,\n  type AnyFormatInput,\n  type ExtractFormatType,\n  type FormatInput,\n  type Format,\n  type FormatSpec,\n  type OutputParser,\n} from \"@/llm/formatting\";\nimport { promoteToMessages } from \"@/llm/messages\";\nimport { Model, useModel } from \"@/llm/models\";\nimport { ContextResponse } from \"@/llm/responses/context-response\";\nimport { ContextStreamResponse } from \"@/llm/responses/context-stream-response\";\n\n// ============================================================================\n// Type Utilities for Context Detection\n// ============================================================================\n\n/**\n * Extract DepsT from T if T has a `ctx: Context<DepsT>` property.\n * Returns `never` if T doesn't have a context property.\n */\nexport type ExtractDeps<T> = T extends { ctx: Context<infer D> } ? D : never;\n\n/**\n * Extract the variables type from T by removing the `ctx` property.\n */\nexport type ExtractVars<T> = Omit<T, \"ctx\">;\n\n// ============================================================================\n// Template Types\n// ============================================================================\n\n/**\n * A template function that generates message content from variables.\n *\n * @template T - The type of variables the template accepts.\n */\nexport type MessageTemplate<T> = (vars: T) => UserContent | readonly Message[];\n\n/**\n * Template function type - either takes no args or takes vars of type T.\n */\nexport type TemplateFunc<T> =\n  | (() => UserContent | readonly Message[])\n  | ((vars: T) => UserContent | readonly Message[]);\n\n/**\n * The combined context and variables object passed to context template functions.\n *\n * @template T - The type of variables the template accepts.\n * @template DepsT - The type of dependencies in the context.\n */\nexport type ContextMessageTemplate<T, DepsT> = { ctx: Context<DepsT> } & T;\n\n/**\n * Context template function type - takes an object with ctx and vars.\n *\n * @template T - The type of variables the template accepts.\n * @template DepsT - The type of dependencies in the context.\n */\nexport type ContextTemplateFunc<T, DepsT> = (\n  args: ContextMessageTemplate<T, DepsT>,\n) => UserContent | readonly Message[];\n\n// ============================================================================\n// Prompt Args Types\n// ============================================================================\n\n/**\n * Arguments for defining a prompt.\n *\n * @template T - The type of variables the template accepts. Defaults to NoVars.\n * @template F - The format input type. The output type F is derived via ExtractFormatType<F>.\n */\nexport interface PromptArgs<T = NoVars, F extends AnyFormatInput = undefined> {\n  /** Optional tools to make available to the model. */\n  tools?: Tools;\n  /**\n   * Optional format specification for structured output.\n   * Can be a Zod schema, Format, FormatSpec, or OutputParser.\n   * The output type is automatically inferred from this format.\n   */\n  format?: F;\n  /** A function that generates message content (optionally from variables). */\n  template: TemplateFunc<T>;\n}\n\n/**\n * Arguments for defining a context-aware prompt.\n * Used when T includes `ctx: Context<DepsT>`.\n *\n * @template T - The full template parameter type including ctx.\n * @template F - The format input type.\n */\nexport interface ContextPromptArgs<\n  T = NoVars,\n  F extends AnyFormatInput = undefined,\n> {\n  /** Optional tools to make available to the model. */\n  tools?: ExtractDeps<T> extends never ? Tools : ContextTools<ExtractDeps<T>>;\n  /**\n   * Optional format specification for structured output.\n   * Can be a Zod schema, Format, FormatSpec, or OutputParser.\n   */\n  format?: F;\n  /** A function that generates message content from context (and optionally variables). */\n  template: TemplateFunc<T>;\n}\n\n// ============================================================================\n// Prompt Interface (Non-Context)\n// ============================================================================\n\n/**\n * A prompt that can be called with a model to generate a response.\n *\n * Created by `definePrompt()`. The prompt is callable and also has a\n * `messages()` method for getting the raw messages without calling the LLM.\n *\n * @template T - The type of variables the prompt accepts. Defaults to empty object.\n * @template F - The format input type. The output type F is derived via ExtractFormatType<F>.\n *\n * @example With variables\n * ```typescript\n * const recommendBook = definePrompt<{ genre: string }>({\n *   template: ({ genre }) => `Recommend a ${genre} book`,\n * });\n *\n * const response = await recommendBook(model, { genre: 'fantasy' });\n * const messages = recommendBook.messages({ genre: 'fantasy' });\n * ```\n *\n * @example Without variables\n * ```typescript\n * const sayHello = definePrompt({\n *   template: () => 'Hello!',\n * });\n * const response = await sayHello(model);\n * ```\n */\nexport interface Prompt<T = NoVars, F extends AnyFormatInput = undefined> {\n  /**\n   * Call the prompt with a model and variables to generate a response.\n   *\n   * @param model - The model to use, either a Model instance or model ID string.\n   * @param vars - The variables to pass to the template.\n   * @returns A promise that resolves to the LLM response.\n   */\n  (\n    model: Model | ModelId,\n    ...args: keyof T extends never ? [] : [vars: T]\n  ): Promise<Response<ExtractFormatType<F>>>;\n\n  /**\n   * Call the prompt with a model and variables to generate a response.\n   * This is the method form of the callable interface.\n   *\n   * @param model - The model to use, either a Model instance or model ID string.\n   * @param vars - The variables to pass to the template.\n   * @returns A promise that resolves to the LLM response.\n   */\n  call(\n    model: Model | ModelId,\n    ...args: keyof T extends never ? [] : [vars: T]\n  ): Promise<Response<ExtractFormatType<F>>>;\n\n  /**\n   * Stream the prompt with a model and variables to generate a streaming response.\n   *\n   * @param model - The model to use, either a Model instance or model ID string.\n   * @param vars - The variables to pass to the template.\n   * @returns A promise that resolves to the streaming LLM response.\n   *\n   * @example\n   * ```typescript\n   * const response = await prompt.stream(model, { genre: 'fantasy' });\n   * for await (const text of response.textStream()) {\n   *   process.stdout.write(text);\n   * }\n   * ```\n   */\n  stream(\n    model: Model | ModelId,\n    ...args: keyof T extends never ? [] : [vars: T]\n  ): Promise<StreamResponse<ExtractFormatType<F>>>;\n\n  /**\n   * Get the messages for this prompt without calling the LLM.\n   *\n   * @param vars - The variables to pass to the template.\n   * @returns The messages that would be sent to the LLM.\n   */\n  messages(...args: keyof T extends never ? [] : [vars: T]): readonly Message[];\n\n  /**\n   * The tools available to this prompt.\n   */\n  readonly tools: Tools | undefined;\n\n  /**\n   * The format specification for structured output, if any.\n   */\n  readonly format: FormatInput<ExtractFormatType<F>>;\n\n  /**\n   * The underlying template function.\n   */\n  readonly template: TemplateFunc<T>;\n}\n\n// ============================================================================\n// Context Prompt Interface\n// ============================================================================\n\n/**\n * A context-aware prompt that can be called with a model and context to generate a response.\n *\n * Created by `definePrompt()` when the template type includes `ctx: Context<DepsT>`.\n * The prompt is callable and also has a `messages()` method for getting the raw messages.\n *\n * @template T - The type of variables the prompt accepts. Defaults to empty object.\n * @template DepsT - The type of dependencies in the context.\n * @template F - The format input type. The output type is derived via ExtractFormatType<F>.\n *\n * @example With variables\n * ```typescript\n * interface MyDeps { userId: string; }\n *\n * const greetUser = definePrompt<{ ctx: Context<MyDeps>; greeting: string }>({\n *   template: ({ ctx, greeting }) => `${greeting}, user ${ctx.deps.userId}!`,\n * });\n *\n * const ctx = createContext<MyDeps>({ userId: '123' });\n * const response = await greetUser(model, ctx, { greeting: 'Hello' });\n * const messages = greetUser.messages(ctx, { greeting: 'Hello' });\n * ```\n *\n * @example Without variables\n * ```typescript\n * interface MyDeps { userId: string; }\n *\n * const sayHello = definePrompt<{ ctx: Context<MyDeps> }>({\n *   template: ({ ctx }) => `Hello, user ${ctx.deps.userId}!`,\n * });\n *\n * const response = await sayHello(model, ctx);\n * ```\n */\nexport interface ContextPrompt<\n  T = NoVars,\n  DepsT = unknown,\n  F extends AnyFormatInput = undefined,\n> {\n  /**\n   * Call the prompt with a model, context, and variables to generate a response.\n   *\n   * @param model - The model to use, either a Model instance or model ID string.\n   * @param ctx - The context containing dependencies.\n   * @param vars - The variables to pass to the template.\n   * @returns A promise that resolves to the LLM response.\n   */\n  (\n    model: Model | ModelId,\n    ctx: Context<DepsT>,\n    ...args: keyof T extends never ? [] : [vars: T]\n  ): Promise<ContextResponse<DepsT, ExtractFormatType<F>>>;\n\n  /**\n   * Call the prompt with a model, context, and variables to generate a response.\n   * This is the method form of the callable interface.\n   *\n   * @param model - The model to use, either a Model instance or model ID string.\n   * @param ctx - The context containing dependencies.\n   * @param vars - The variables to pass to the template.\n   * @returns A promise that resolves to the LLM response.\n   */\n  call(\n    model: Model | ModelId,\n    ctx: Context<DepsT>,\n    ...args: keyof T extends never ? [] : [vars: T]\n  ): Promise<ContextResponse<DepsT, ExtractFormatType<F>>>;\n\n  /**\n   * Stream the prompt with a model, context, and variables to generate a streaming response.\n   *\n   * @param model - The model to use, either a Model instance or model ID string.\n   * @param ctx - The context containing dependencies.\n   * @param vars - The variables to pass to the template.\n   * @returns A promise that resolves to the streaming LLM response.\n   *\n   * @example\n   * ```typescript\n   * const response = await prompt.stream(model, ctx, { greeting: 'Hello' });\n   * for await (const text of response.textStream()) {\n   *   process.stdout.write(text);\n   * }\n   * ```\n   */\n  stream(\n    model: Model | ModelId,\n    ctx: Context<DepsT>,\n    ...args: keyof T extends never ? [] : [vars: T]\n  ): Promise<ContextStreamResponse<DepsT, ExtractFormatType<F>>>;\n\n  /**\n   * Get the messages for this prompt without calling the LLM.\n   *\n   * @param ctx - The context containing dependencies.\n   * @param vars - The variables to pass to the template.\n   * @returns The messages that would be sent to the LLM.\n   */\n  messages(\n    ctx: Context<DepsT>,\n    ...args: keyof T extends never ? [] : [vars: T]\n  ): readonly Message[];\n\n  /**\n   * The tools available to this prompt.\n   */\n  readonly tools: ContextTools<DepsT> | undefined;\n\n  /**\n   * The format specification for structured output, if any.\n   */\n  readonly format:\n    | Format<ExtractFormatType<F>>\n    | FormatSpec<ExtractFormatType<F>>\n    | ZodLike\n    | OutputParser<ExtractFormatType<F>>\n    | null\n    | undefined;\n\n  /**\n   * The underlying template function.\n   */\n  readonly template: ContextTemplateFunc<T, DepsT>;\n}\n\n// ============================================================================\n// Unified Prompt Type\n// ============================================================================\n\n/**\n * Unified prompt type that returns either Prompt or ContextPrompt\n * based on whether T includes `ctx: Context<DepsT>`.\n */\nexport type UnifiedPrompt<T, F extends AnyFormatInput = undefined> =\n  ExtractDeps<T> extends never\n    ? Prompt<T, F>\n    : ContextPrompt<ExtractVars<T>, ExtractDeps<T>, F>;\n\n// ============================================================================\n// definePrompt Function Overloads\n// ============================================================================\n\n/**\n * Define a prompt that automatically detects context from the template type.\n *\n * When T includes `ctx: Context<DepsT>`, returns a ContextPrompt.\n * Otherwise returns a regular Prompt.\n *\n * @template T - The type of the template parameter (including ctx if context-aware).\n * @template F - The format input type. The output type is derived via ExtractFormatType<F>.\n * @param args - The prompt arguments including the template.\n * @returns A callable prompt (context-aware if T includes ctx).\n *\n * @example Prompt without variables\n * ```typescript\n * const sayHello = definePrompt({\n *   template: () => 'Hello!',\n * });\n * const response = await sayHello(model);\n * ```\n *\n * @example Regular prompt with variables\n * ```typescript\n * const recommendBook = definePrompt<{ genre: string }>({\n *   template: ({ genre }) => `Recommend a ${genre} book`,\n * });\n * const response = await recommendBook(model, { genre: 'fantasy' });\n * ```\n *\n * @example Context-aware prompt\n * ```typescript\n * interface MyDeps { userId: string; }\n *\n * const greetUser = definePrompt<{ ctx: Context<MyDeps>; greeting: string }>({\n *   template: ({ ctx, greeting }) => `${greeting}, user ${ctx.deps.userId}!`,\n * });\n *\n * const ctx = createContext<MyDeps>({ userId: '123' });\n * const response = await greetUser(model, ctx, { greeting: 'Hello' });\n * ```\n */\nexport function definePrompt<\n  T extends Record<string, unknown> = NoVars,\n  F extends AnyFormatInput = undefined,\n>(args: PromptArgs<T, F> | ContextPromptArgs<T, F>): UnifiedPrompt<T, F>;\n\n// ============================================================================\n// Implementation\n// ============================================================================\n\n// Implementation\nexport function definePrompt<T, F extends AnyFormatInput>({\n  tools,\n  format,\n  template,\n}: PromptArgs<T, F> | ContextPromptArgs<T, F>): UnifiedPrompt<T, F> {\n  // Resolve format at definition time (uses 'tool' as default mode)\n  const resolvedFormat = resolveFormat(format, \"tool\");\n\n  // Create messages function that handles both context and non-context cases\n  const messagesImpl = (...args: unknown[]): readonly Message[] => {\n    const firstArg = args[0];\n\n    // Check if first argument is a Context\n    if (isContext(firstArg)) {\n      // Context case: first arg is ctx, second is vars\n      const ctx = firstArg;\n      const vars = args[1] as ExtractVars<T> | undefined;\n      const templateArgs = { ctx, ...vars } as T;\n      const content =\n        template.length === 0\n          ? (template as () => UserContent | readonly Message[])()\n          : (template as (args: T) => UserContent | readonly Message[])(\n              templateArgs,\n            );\n      return promoteToMessages(content);\n    } else {\n      // Non-context case: first arg is vars (or undefined)\n      const vars = firstArg as T | undefined;\n      const content =\n        template.length === 0\n          ? (template as () => UserContent | readonly Message[])()\n          : (template as (vars: T) => UserContent | readonly Message[])(\n              vars as T,\n            );\n      return promoteToMessages(content);\n    }\n  };\n\n  // Create call function\n  const callImpl = async (\n    ...args: unknown[]\n  ): Promise<\n    | Response<ExtractFormatType<F>>\n    | ContextResponse<unknown, ExtractFormatType<F>>\n  > => {\n    const modelArg = args[0] as Model | ModelId;\n    const secondArg = args[1];\n\n    if (isContext(secondArg)) {\n      // Context case: call(model, ctx, vars?)\n      const ctx = secondArg;\n      const vars = args[2] as ExtractVars<T> | undefined;\n      const msgs = messagesImpl(ctx, vars);\n      return useModel(modelArg).contextCall(ctx, msgs, {\n        tools: tools as ContextTools<unknown>,\n        format: resolvedFormat,\n      }) as Promise<ContextResponse<unknown, ExtractFormatType<F>>>;\n    } else {\n      // Non-context case: call(model, vars?)\n      const vars = secondArg as T | undefined;\n      const msgs = messagesImpl(vars);\n      return useModel(modelArg).call(msgs, {\n        tools: tools as Tools,\n        format: resolvedFormat,\n      }) as Promise<Response<ExtractFormatType<F>>>;\n    }\n  };\n\n  // Create callable wrapper\n  const callable = async (\n    ...args: unknown[]\n  ): Promise<\n    | Response<ExtractFormatType<F>>\n    | ContextResponse<unknown, ExtractFormatType<F>>\n  > => {\n    return callImpl(...args);\n  };\n\n  // Create stream function\n  const streamImpl = async (\n    ...args: unknown[]\n  ): Promise<\n    | StreamResponse<ExtractFormatType<F>>\n    | ContextStreamResponse<unknown, ExtractFormatType<F>>\n  > => {\n    const modelArg = args[0] as Model | ModelId;\n    const secondArg = args[1];\n\n    if (isContext(secondArg)) {\n      // Context case: stream(model, ctx, vars?)\n      const ctx = secondArg;\n      const vars = args[2] as ExtractVars<T> | undefined;\n      const msgs = messagesImpl(ctx, vars);\n      return useModel(modelArg).contextStream(ctx, msgs, {\n        tools: tools as ContextTools<unknown>,\n        format: resolvedFormat,\n      }) as Promise<ContextStreamResponse<unknown, ExtractFormatType<F>>>;\n    } else {\n      // Non-context case: stream(model, vars?)\n      const vars = secondArg as T | undefined;\n      const msgs = messagesImpl(vars);\n      return useModel(modelArg).stream(msgs, {\n        tools: tools as Tools,\n        format: resolvedFormat,\n      }) as Promise<StreamResponse<ExtractFormatType<F>>>;\n    }\n  };\n\n  return Object.assign(callable, {\n    call: callImpl,\n    stream: streamImpl,\n    messages: messagesImpl,\n    tools,\n    format,\n    template,\n  }) as UnifiedPrompt<T, F>;\n}\n","/**\n * Call definition and creation utilities.\n *\n * A Call is a Prompt with a bundled Model - it can be invoked directly\n * without passing a model argument.\n *\n * This module provides a unified `defineCall` function that automatically\n * detects whether a call is context-aware based on the template type parameter.\n * If T includes `ctx: Context<DepsT>`, a ContextCall is returned; otherwise\n * a regular Call is returned.\n */\n\nimport type {\n  AnyFormatInput,\n  ExtractFormatType,\n  FormatInput,\n  Format,\n  FormatSpec,\n  OutputParser,\n} from \"@/llm/formatting\";\nimport type { Params } from \"@/llm/models/params\";\nimport type { ModelId } from \"@/llm/providers/model-id\";\nimport type { Response } from \"@/llm/responses\";\nimport type { ContextResponse } from \"@/llm/responses/context-response\";\nimport type { ContextStreamResponse } from \"@/llm/responses/context-stream-response\";\nimport type { StreamResponse } from \"@/llm/responses/stream-response\";\nimport type { ContextTools, Tools, ZodLike } from \"@/llm/tools\";\nimport type { NoVars } from \"@/llm/types\";\n\nimport { type Context, isContext } from \"@/llm/context\";\nimport { Model, useModel } from \"@/llm/models\";\nimport {\n  definePrompt,\n  type ContextPrompt,\n  type ContextTemplateFunc,\n  type ExtractDeps,\n  type ExtractVars,\n  type Prompt,\n  type PromptArgs,\n  type TemplateFunc,\n} from \"@/llm/prompts\";\n\n// ============================================================================\n// Call Args Types\n// ============================================================================\n\n/**\n * Arguments for defining a call.\n *\n * @template T - The type of variables the template accepts. Defaults to NoVars.\n * @template F - The format input type. The output type F is derived via ExtractFormatType<F>.\n */\nexport interface CallArgs<\n  T = NoVars,\n  F extends AnyFormatInput = undefined,\n> extends Params {\n  /** The model to use, either a Model instance or model ID string. */\n  model: Model | ModelId;\n  /** Optional tools to make available to the model. */\n  tools?: Tools;\n  /**\n   * Optional format specification for structured output.\n   * Can be a Zod schema, Format, FormatSpec, or OutputParser.\n   * The output type is automatically inferred from this format.\n   */\n  format?: F;\n  /** A function that generates message content (optionally from variables). */\n  template: TemplateFunc<T>;\n}\n\n/**\n * Arguments for defining a context-aware call.\n * Used when T includes `ctx: Context<DepsT>`.\n *\n * @template T - The full template parameter type including ctx.\n * @template F - The format input type.\n */\nexport interface ContextCallArgs<\n  T = NoVars,\n  F extends AnyFormatInput = undefined,\n> extends Params {\n  /** The model to use, either a Model instance or model ID string. */\n  model: Model | ModelId;\n  /** Optional tools to make available to the model. */\n  tools?: ExtractDeps<T> extends never ? Tools : ContextTools<ExtractDeps<T>>;\n  /**\n   * Optional format specification for structured output.\n   * Can be a Zod schema, Format, FormatSpec, or OutputParser.\n   */\n  format?: F;\n  /** A function that generates message content from context (and optionally variables). */\n  template: TemplateFunc<T>;\n}\n\n// ============================================================================\n// Call Interface (Non-Context)\n// ============================================================================\n\n/**\n * A call that can be invoked directly to generate a response.\n *\n * Created by `defineCall()`. Unlike a `Prompt`, a `Call` has a model bundled in,\n * so it can be invoked without passing a model argument.\n *\n * @template T - The type of variables the call accepts. Defaults to empty object.\n * @template F - The format input type. The output type F is derived via ExtractFormatType<F>.\n *\n * @example With variables\n * ```typescript\n * const recommendBook = defineCall<{ genre: string }>({\n *   model: 'anthropic/claude-sonnet-4-20250514',\n *   template: ({ genre }) => `Recommend a ${genre} book`,\n * });\n *\n * const response = await recommendBook({ genre: 'fantasy' });\n * ```\n *\n * @example Without variables\n * ```typescript\n * const sayHello = defineCall({\n *   model: 'anthropic/claude-sonnet-4-20250514',\n *   template: () => 'Hello!',\n * });\n * const response = await sayHello();\n * ```\n */\nexport interface Call<T = NoVars, F extends AnyFormatInput = undefined> {\n  /**\n   * Call directly to generate a response (model is bundled).\n   *\n   * @param vars - The variables to pass to the template.\n   * @returns A promise that resolves to the LLM response.\n   */\n  (\n    ...args: keyof T extends never ? [] : [vars: T]\n  ): Promise<Response<ExtractFormatType<F>>>;\n\n  /**\n   * Call directly to generate a response (model is bundled).\n   * This is the method form of the callable interface.\n   *\n   * @param vars - The variables to pass to the template.\n   * @returns A promise that resolves to the LLM response.\n   */\n  call(\n    ...args: keyof T extends never ? [] : [vars: T]\n  ): Promise<Response<ExtractFormatType<F>>>;\n\n  /**\n   * Stream directly to generate a streaming response (model is bundled).\n   *\n   * @param vars - The variables to pass to the template.\n   * @returns A promise that resolves to the streaming LLM response.\n   *\n   * @example\n   * ```typescript\n   * const response = await call.stream({ genre: 'fantasy' });\n   * for await (const text of response.textStream()) {\n   *   process.stdout.write(text);\n   * }\n   * ```\n   */\n  stream(\n    ...args: keyof T extends never ? [] : [vars: T]\n  ): Promise<StreamResponse<ExtractFormatType<F>>>;\n\n  /**\n   * The model used for generating responses.\n   * Returns the context model if one is set via `withModel`, otherwise returns `defaultModel`.\n   */\n  readonly model: Model;\n\n  /**\n   * The default model configured when defining this call.\n   * Use `model` to get the effective model (which respects context).\n   */\n  readonly defaultModel: Model;\n\n  /**\n   * The tools available to this call.\n   */\n  readonly tools: Tools | undefined;\n\n  /**\n   * The format specification for structured output, if any.\n   */\n  readonly format: FormatInput<ExtractFormatType<F>>;\n\n  /**\n   * The underlying prompt.\n   */\n  readonly prompt: Prompt<T, F>;\n\n  /**\n   * The underlying template function.\n   */\n  readonly template: TemplateFunc<T>;\n}\n\n// ============================================================================\n// Context Call Interface\n// ============================================================================\n\n/**\n * A context-aware call that can be invoked directly with a context to generate a response.\n *\n * Created by `defineCall()` when the template type includes `ctx: Context<DepsT>`.\n * Unlike a `ContextPrompt`, a `ContextCall` has a model bundled in, so it can be\n * invoked without passing a model argument.\n *\n * @template T - The type of variables the call accepts. Defaults to empty object.\n * @template DepsT - The type of dependencies in the context.\n * @template F - The format input type. The output type is derived via ExtractFormatType<F>.\n *\n * @example With variables\n * ```typescript\n * interface MyDeps { userId: string; }\n *\n * const greetUser = defineCall<{ ctx: Context<MyDeps>; greeting: string }>({\n *   model: 'anthropic/claude-sonnet-4-20250514',\n *   template: ({ ctx, greeting }) => `${greeting}, user ${ctx.deps.userId}!`,\n * });\n *\n * const ctx = createContext<MyDeps>({ userId: '123' });\n * const response = await greetUser(ctx, { greeting: 'Hello' });\n * ```\n *\n * @example Without variables\n * ```typescript\n * interface MyDeps { userId: string; }\n *\n * const sayHello = defineCall<{ ctx: Context<MyDeps> }>({\n *   model: 'anthropic/claude-sonnet-4-20250514',\n *   template: ({ ctx }) => `Hello, user ${ctx.deps.userId}!`,\n * });\n *\n * const ctx = createContext<MyDeps>({ userId: '123' });\n * const response = await sayHello(ctx);\n * ```\n */\nexport interface ContextCall<\n  T = NoVars,\n  DepsT = unknown,\n  F extends AnyFormatInput = undefined,\n> {\n  /**\n   * Call directly with context to generate a response (model is bundled).\n   *\n   * @param ctx - The context containing dependencies.\n   * @param vars - The variables to pass to the template.\n   * @returns A promise that resolves to the LLM response.\n   */\n  (\n    ctx: Context<DepsT>,\n    ...args: keyof T extends never ? [] : [vars: T]\n  ): Promise<ContextResponse<DepsT, ExtractFormatType<F>>>;\n\n  /**\n   * Call directly with context to generate a response (model is bundled).\n   * This is the method form of the callable interface.\n   *\n   * @param ctx - The context containing dependencies.\n   * @param vars - The variables to pass to the template.\n   * @returns A promise that resolves to the LLM response.\n   */\n  call(\n    ctx: Context<DepsT>,\n    ...args: keyof T extends never ? [] : [vars: T]\n  ): Promise<ContextResponse<DepsT, ExtractFormatType<F>>>;\n\n  /**\n   * Stream directly with context to generate a streaming response (model is bundled).\n   *\n   * @param ctx - The context containing dependencies.\n   * @param vars - The variables to pass to the template.\n   * @returns A promise that resolves to the streaming LLM response.\n   *\n   * @example\n   * ```typescript\n   * const response = await call.stream(ctx, { greeting: 'Hello' });\n   * for await (const text of response.textStream()) {\n   *   process.stdout.write(text);\n   * }\n   * ```\n   */\n  stream(\n    ctx: Context<DepsT>,\n    ...args: keyof T extends never ? [] : [vars: T]\n  ): Promise<ContextStreamResponse<DepsT, ExtractFormatType<F>>>;\n\n  /**\n   * The model used for generating responses.\n   * Returns the context model if one is set via `withModel`, otherwise returns `defaultModel`.\n   */\n  readonly model: Model;\n\n  /**\n   * The default model configured when defining this call.\n   * Use `model` to get the effective model (which respects context).\n   */\n  readonly defaultModel: Model;\n\n  /**\n   * The tools available to this call.\n   */\n  readonly tools: ContextTools<DepsT> | undefined;\n\n  /**\n   * The format specification for structured output, if any.\n   */\n  readonly format:\n    | Format<ExtractFormatType<F>>\n    | FormatSpec<ExtractFormatType<F>>\n    | ZodLike\n    | OutputParser<ExtractFormatType<F>>\n    | null\n    | undefined;\n\n  /**\n   * The underlying context prompt.\n   */\n  readonly prompt: ContextPrompt<T, DepsT, F>;\n\n  /**\n   * The underlying template function.\n   */\n  readonly template: ContextTemplateFunc<T, DepsT>;\n}\n\n// ============================================================================\n// Unified Call Type\n// ============================================================================\n\n/**\n * Unified call type that returns either Call or ContextCall\n * based on whether T includes `ctx: Context<DepsT>`.\n */\nexport type UnifiedCall<T, F extends AnyFormatInput = undefined> =\n  ExtractDeps<T> extends never\n    ? Call<T, F>\n    : ContextCall<ExtractVars<T>, ExtractDeps<T>, F>;\n\n/**\n * A builder function returned when defineCall is called with only a type parameter.\n * Allows specifying the variables type explicitly while inferring the format type.\n *\n * @template T - The type of variables the call accepts (may include ctx for context calls).\n */\nexport interface CallBuilder<T extends Record<string, unknown>> {\n  <F extends AnyFormatInput = undefined>(\n    args: CallArgs<T, F> | ContextCallArgs<T, F>,\n  ): UnifiedCall<T, F>;\n}\n\n// ============================================================================\n// Core Implementation\n// ============================================================================\n\n// Core implementation - separated to avoid overload matching issues with curried calls\nfunction createCall<T, F extends AnyFormatInput>({\n  model,\n  tools,\n  format,\n  template,\n  ...params\n}: CallArgs<T, F> | ContextCallArgs<T, F>): UnifiedCall<T, F> {\n  if (typeof model !== \"string\" && Object.keys(params).length > 0) {\n    throw new Error(\n      \"Cannot pass params when model is a Model instance. Use new Model(id, params) instead.\",\n    );\n  }\n\n  // Resolve the default model at definition time (bakes in params)\n  const defaultModel: Model =\n    typeof model === \"string\" ? new Model(model, params) : model;\n\n  // Create the unified prompt (it handles both context and non-context cases)\n  const prompt = definePrompt({ tools, format, template } as PromptArgs<\n    T & Record<string, unknown>,\n    F\n  >);\n\n  // Create call function that handles both context and non-context cases\n  // We use type assertions here because the unified prompt handles runtime detection\n  const callImpl = async (\n    ...args: unknown[]\n  ): Promise<\n    | Response<ExtractFormatType<F>>\n    | ContextResponse<unknown, ExtractFormatType<F>>\n  > => {\n    const firstArg = args[0];\n\n    if (isContext(firstArg)) {\n      // Context case: call(ctx, vars?)\n      const ctx = firstArg;\n      const vars = args[1] as ExtractVars<T> | undefined;\n      // Use the prompt's internal implementation which handles both cases\n      const contextPrompt = prompt as unknown as {\n        call(\n          model: Model,\n          ctx: Context<unknown>,\n          vars?: ExtractVars<T>,\n        ): Promise<ContextResponse<unknown, ExtractFormatType<F>>>;\n      };\n      return contextPrompt.call(useModel(defaultModel), ctx, vars);\n    } else {\n      // Non-context case: call(vars?)\n      const vars = firstArg as T | undefined;\n      const regularPrompt = prompt as unknown as {\n        call(model: Model, vars?: T): Promise<Response<ExtractFormatType<F>>>;\n      };\n      return regularPrompt.call(useModel(defaultModel), vars);\n    }\n  };\n\n  // Create callable wrapper\n  const callable = async (\n    ...args: unknown[]\n  ): Promise<\n    | Response<ExtractFormatType<F>>\n    | ContextResponse<unknown, ExtractFormatType<F>>\n  > => {\n    return callImpl(...args);\n  };\n\n  // Create stream function\n  const streamImpl = async (\n    ...args: unknown[]\n  ): Promise<\n    | StreamResponse<ExtractFormatType<F>>\n    | ContextStreamResponse<unknown, ExtractFormatType<F>>\n  > => {\n    const firstArg = args[0];\n\n    if (isContext(firstArg)) {\n      // Context case: stream(ctx, vars?)\n      const ctx = firstArg;\n      const vars = args[1] as ExtractVars<T> | undefined;\n      const contextPrompt = prompt as unknown as {\n        stream(\n          model: Model,\n          ctx: Context<unknown>,\n          vars?: ExtractVars<T>,\n        ): Promise<ContextStreamResponse<unknown, ExtractFormatType<F>>>;\n      };\n      return contextPrompt.stream(useModel(defaultModel), ctx, vars);\n    } else {\n      // Non-context case: stream(vars?)\n      const vars = firstArg as T | undefined;\n      const regularPrompt = prompt as unknown as {\n        stream(\n          model: Model,\n          vars?: T,\n        ): Promise<StreamResponse<ExtractFormatType<F>>>;\n      };\n      return regularPrompt.stream(useModel(defaultModel), vars);\n    }\n  };\n\n  const definedCall = Object.assign(callable, {\n    defaultModel,\n    call: callImpl,\n    stream: streamImpl,\n    tools,\n    format,\n    prompt,\n    template,\n  });\n\n  Object.defineProperty(definedCall, \"model\", {\n    get: () => useModel(defaultModel),\n    enumerable: true,\n  });\n\n  return definedCall as unknown as UnifiedCall<T, F>;\n}\n\n// ============================================================================\n// defineCall Function Overloads\n// ============================================================================\n\n/**\n * Define a call with explicit variables type, returning a builder that infers format.\n *\n * This overload enables specifying the variables type upfront while still allowing\n * the format type to be inferred from the `format` property.\n *\n * @template T - The type of variables the template accepts (may include ctx for context calls).\n * @returns A builder function that accepts call arguments and infers the format type.\n *\n * @example With explicit variables and inferred format\n * ```typescript\n * const recommendBook = defineCall<{ genre: string }>()({\n *   model: 'anthropic/claude-sonnet-4-20250514',\n *   format: defineFormat<Book>({ mode: 'tool' }),\n *   template: ({ genre }) => `Recommend a ${genre} book`,\n * });\n *\n * const response = await recommendBook({ genre: 'fantasy' });\n * const book = response.parse(); // Typed as Book\n * ```\n *\n * @example Context-aware call with explicit type\n * ```typescript\n * interface MyDeps { userId: string; }\n *\n * const greetUser = defineCall<{ ctx: Context<MyDeps>; greeting: string }>()({\n *   model: 'anthropic/claude-sonnet-4-20250514',\n *   template: ({ ctx, greeting }) => `${greeting}, user ${ctx.deps.userId}!`,\n * });\n *\n * const ctx = createContext<MyDeps>({ userId: '123' });\n * const response = await greetUser(ctx, { greeting: 'Hello' });\n * ```\n */\nexport function defineCall<T extends Record<string, unknown>>(): CallBuilder<T>;\n\n/**\n * Define a call that automatically detects context from the template type.\n *\n * When T includes `ctx: Context<DepsT>`, returns a ContextCall.\n * Otherwise returns a regular Call.\n *\n * Both the variables type and format type are inferred from the arguments.\n * Type the template parameter to enable variables inference.\n *\n * @template T - The type of variables the template accepts (may include ctx for context calls).\n * @template F - The format input type (inferred from format property).\n * @param args - The call arguments including model, template, and optional parameters.\n * @returns A callable that can be invoked directly with variables (and context if T includes ctx).\n *\n * @example Call without variables\n * ```typescript\n * const sayHello = defineCall({\n *   model: 'anthropic/claude-sonnet-4-20250514',\n *   template: () => 'Hello!',\n * });\n * const response = await sayHello();\n * ```\n *\n * @example Regular call with variables\n * ```typescript\n * const recommendBook = defineCall({\n *   model: 'anthropic/claude-sonnet-4-20250514',\n *   format: defineFormat<Book>({ mode: 'tool' }),\n *   template: ({ genre }: { genre: string }) => `Recommend a ${genre} book`,\n * });\n * const response = await recommendBook({ genre: 'fantasy' });\n * ```\n *\n * @example Context-aware call\n * ```typescript\n * interface MyDeps { userId: string; }\n *\n * const greetUser = defineCall({\n *   model: 'anthropic/claude-sonnet-4-20250514',\n *   template: ({ ctx, greeting }: { ctx: Context<MyDeps>; greeting: string }) =>\n *     `${greeting}, user ${ctx.deps.userId}!`,\n * });\n *\n * const ctx = createContext<MyDeps>({ userId: '123' });\n * const response = await greetUser(ctx, { greeting: 'Hello' });\n * ```\n */\nexport function defineCall<\n  T extends Record<string, unknown> = NoVars,\n  F extends AnyFormatInput = undefined,\n>(args: CallArgs<T, F> | ContextCallArgs<T, F>): UnifiedCall<T, F>;\n\n// ============================================================================\n// Implementation\n// ============================================================================\n\n// Implementation\nexport function defineCall<T, F extends AnyFormatInput>(\n  args?: CallArgs<T, F> | ContextCallArgs<T, F>,\n): UnifiedCall<T, F> | CallBuilder<T & Record<string, unknown>> {\n  // If no args provided, return a builder function for curried usage\n  if (args === undefined) {\n    return (<F2 extends AnyFormatInput = undefined>(\n      builderArgs: CallArgs<T, F2> | ContextCallArgs<T, F2>,\n    ): UnifiedCall<T, F2> => {\n      return createCall(builderArgs);\n    }) as CallBuilder<T & Record<string, unknown>>;\n  }\n\n  return createCall(args);\n}\n"]}

package/dist/model-T6IQ7UUA.js

@@ -0,0 +1,4 @@
+export { Model, model } from './chunk-A6ZCB7BU.js';
+import './chunk-NSBPE2FW.js';
+//# sourceMappingURL=model-T6IQ7UUA.js.map
+//# sourceMappingURL=model-T6IQ7UUA.js.map

package/dist/model-T6IQ7UUA.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"model-T6IQ7UUA.js"}

package/dist/tool-schema-Dh-RLHhC.d.cts

@@ -0,0 +1,45 @@
+/**
+ * JSON Schema property definition for a single tool parameter.
+ */
+interface JsonSchemaProperty {
+    type?: string;
+    description?: string;
+    enum?: readonly (string | number | boolean)[];
+    items?: JsonSchemaProperty;
+    properties?: Record<string, JsonSchemaProperty>;
+    required?: readonly string[];
+    additionalProperties?: boolean;
+    default?: unknown;
+    $ref?: string;
+    oneOf?: readonly JsonSchemaProperty[];
+    allOf?: readonly JsonSchemaProperty[];
+    anyOf?: readonly JsonSchemaProperty[];
+}
+/**
+ * Tool parameter schema following JSON Schema format.
+ *
+ * This represents the complete parameter schema for a tool,
+ * including all properties, required fields, and definitions.
+ */
+interface ToolParameterSchema {
+    readonly type: "object";
+    readonly title?: string;
+    readonly properties: Record<string, JsonSchemaProperty>;
+    readonly required: readonly string[];
+    readonly additionalProperties: false;
+    readonly $defs?: Record<string, JsonSchemaProperty>;
+}
+/**
+ * Complete tool schema including name, description, and parameters.
+ *
+ * This is the provider-agnostic representation of a tool that
+ * gets converted to provider-specific formats (OpenAI, Anthropic, etc.).
+ */
+interface ToolSchema {
+    readonly name: string;
+    readonly description: string;
+    readonly parameters: ToolParameterSchema;
+    readonly strict?: boolean;
+}
+
+export type { JsonSchemaProperty as J, ToolSchema as T, ToolParameterSchema as a };

package/dist/tool-schema-Dh-RLHhC.d.ts

@@ -0,0 +1,45 @@
+/**
+ * JSON Schema property definition for a single tool parameter.
+ */
+interface JsonSchemaProperty {
+    type?: string;
+    description?: string;
+    enum?: readonly (string | number | boolean)[];
+    items?: JsonSchemaProperty;
+    properties?: Record<string, JsonSchemaProperty>;
+    required?: readonly string[];
+    additionalProperties?: boolean;
+    default?: unknown;
+    $ref?: string;
+    oneOf?: readonly JsonSchemaProperty[];
+    allOf?: readonly JsonSchemaProperty[];
+    anyOf?: readonly JsonSchemaProperty[];
+}
+/**
+ * Tool parameter schema following JSON Schema format.
+ *
+ * This represents the complete parameter schema for a tool,
+ * including all properties, required fields, and definitions.
+ */
+interface ToolParameterSchema {
+    readonly type: "object";
+    readonly title?: string;
+    readonly properties: Record<string, JsonSchemaProperty>;
+    readonly required: readonly string[];
+    readonly additionalProperties: false;
+    readonly $defs?: Record<string, JsonSchemaProperty>;
+}
+/**
+ * Complete tool schema including name, description, and parameters.
+ *
+ * This is the provider-agnostic representation of a tool that
+ * gets converted to provider-specific formats (OpenAI, Anthropic, etc.).
+ */
+interface ToolSchema {
+    readonly name: string;
+    readonly description: string;
+    readonly parameters: ToolParameterSchema;
+    readonly strict?: boolean;
+}
+
+export type { JsonSchemaProperty as J, ToolSchema as T, ToolParameterSchema as a };