libretto 0.4.4 → 0.5.0

package/dist/shared/llm/ai-sdk-adapter.cjs

@@ -1,71 +0,0 @@
-"use strict";
-var __defProp = Object.defineProperty;
-var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __export = (target, all) => {
-  for (var name in all)
-    __defProp(target, name, { get: all[name], enumerable: true });
-};
-var __copyProps = (to, from, except, desc) => {
-  if (from && typeof from === "object" || typeof from === "function") {
-    for (let key of __getOwnPropNames(from))
-      if (!__hasOwnProp.call(to, key) && key !== except)
-        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
-  }
-  return to;
-};
-var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
-var ai_sdk_adapter_exports = {};
-__export(ai_sdk_adapter_exports, {
-  createLLMClientFromModel: () => createLLMClientFromModel
-});
-module.exports = __toCommonJS(ai_sdk_adapter_exports);
-var import_ai = require("ai");
-function createLLMClientFromModel(model) {
-  return {
-    async generateObject(opts) {
-      const { object } = await (0, import_ai.generateObject)({
-        model,
-        schema: opts.schema,
-        prompt: opts.prompt,
-        temperature: opts.temperature ?? 0
-      });
-      return object;
-    },
-    async generateObjectFromMessages(opts) {
-      const messages = opts.messages.map((msg) => {
-        if (typeof msg.content === "string") {
-          return { role: msg.role, content: msg.content };
-        }
-        if (msg.role === "assistant") {
-          return {
-            role: "assistant",
-            content: msg.content.filter((part) => part.type === "text").map((part) => ({ type: "text", text: part.text }))
-          };
-        }
-        return {
-          role: "user",
-          content: msg.content.map(
-            (part) => part.type === "text" ? { type: "text", text: part.text } : {
-              type: "image",
-              image: part.image,
-              ...part.mediaType ? { mediaType: part.mediaType } : {}
-            }
-          )
-        };
-      });
-      const { object } = await (0, import_ai.generateObject)({
-        model,
-        schema: opts.schema,
-        messages,
-        temperature: opts.temperature ?? 0
-      });
-      return object;
-    }
-  };
-}
-// Annotate the CommonJS export names for ESM import in node:
-0 && (module.exports = {
-  createLLMClientFromModel
-});

package/dist/shared/llm/ai-sdk-adapter.d.cts

@@ -1,22 +0,0 @@
-import { LanguageModel } from 'ai';
-import { LLMClient } from './types.cjs';
-import 'zod';
-
-/**
- * Creates a libretto LLMClient from a Vercel AI SDK LanguageModel.
- *
- * This eliminates the need for consumers to write their own adapter
- * when using @ai-sdk/openai, @ai-sdk/anthropic, @ai-sdk/google-vertex,
- * or any other Vercel AI SDK-compatible provider.
- *
- * @example
- * ```typescript
- * import { createLLMClientFromModel } from "libretto/llm";
- * import { openai } from "@ai-sdk/openai";
- *
- * const llmClient = createLLMClientFromModel(openai("gpt-4o"));
- * ```
- */
-declare function createLLMClientFromModel(model: LanguageModel): LLMClient;
-
-export { createLLMClientFromModel };

package/dist/shared/llm/client.cjs

@@ -1,218 +0,0 @@
-"use strict";
-var __create = Object.create;
-var __defProp = Object.defineProperty;
-var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-var __getProtoOf = Object.getPrototypeOf;
-var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __export = (target, all) => {
-  for (var name in all)
-    __defProp(target, name, { get: all[name], enumerable: true });
-};
-var __copyProps = (to, from, except, desc) => {
-  if (from && typeof from === "object" || typeof from === "function") {
-    for (let key of __getOwnPropNames(from))
-      if (!__hasOwnProp.call(to, key) && key !== except)
-        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
-  }
-  return to;
-};
-var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
-  // If the importer is in node compatibility mode or this is not an ESM
-  // file that has been converted to a CommonJS file using a Babel-
-  // compatible transform (i.e. "__esModule" has not been set), then set
-  // "default" to the CommonJS "module.exports" for node compatibility.
-  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
-  mod
-));
-var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
-var client_exports = {};
-__export(client_exports, {
-  createLLMClient: () => createLLMClient,
-  hasProviderCredentials: () => hasProviderCredentials,
-  missingProviderCredentialsMessage: () => missingProviderCredentialsMessage,
-  parseModel: () => parseModel
-});
-module.exports = __toCommonJS(client_exports);
-var import_ai = require("ai");
-const GEMINI_API_KEY_ENV_VARS = [
-  "GEMINI_API_KEY",
-  "GOOGLE_GENERATIVE_AI_API_KEY"
-];
-const VERTEX_PROJECT_ENV_VARS = [
-  "GOOGLE_CLOUD_PROJECT",
-  "GCLOUD_PROJECT"
-];
-const SUPPORTED_PROVIDER_ALIASES = {
-  google: "google",
-  gemini: "google",
-  vertex: "vertex",
-  anthropic: "anthropic",
-  codex: "openai",
-  openai: "openai"
-};
-function readFirstEnvValue(env, names) {
-  for (const name of names) {
-    const value = env[name]?.trim();
-    if (value) return value;
-  }
-  return null;
-}
-function parseModel(model) {
-  const slashIndex = model.indexOf("/");
-  if (slashIndex === -1) {
-    throw new Error(
-      `Invalid model string "${model}". Expected format: "provider/model-id" (for example "openai/gpt-5.4", "anthropic/claude-sonnet-4-6", "google/gemini-3-flash-preview", or "vertex/gemini-2.5-pro").`
-    );
-  }
-  const providerInput = model.slice(0, slashIndex).toLowerCase();
-  const provider = SUPPORTED_PROVIDER_ALIASES[providerInput];
-  const modelId = model.slice(slashIndex + 1);
-  if (!provider) {
-    throw new Error(
-      `Unsupported provider "${providerInput}". Supported providers: openai/codex, anthropic, google (Gemini API), and vertex.`
-    );
-  }
-  return { provider, modelId };
-}
-function hasProviderCredentials(provider, env = process.env) {
-  switch (provider) {
-    case "google":
-      return readFirstEnvValue(env, GEMINI_API_KEY_ENV_VARS) !== null;
-    case "vertex":
-      return readFirstEnvValue(env, VERTEX_PROJECT_ENV_VARS) !== null;
-    case "anthropic":
-      return Boolean(env.ANTHROPIC_API_KEY?.trim());
-    case "openai":
-      return Boolean(env.OPENAI_API_KEY?.trim());
-  }
-}
-function missingProviderCredentialsMessage(provider) {
-  switch (provider) {
-    case "google":
-      return "Gemini API key is missing. Set GEMINI_API_KEY or GOOGLE_GENERATIVE_AI_API_KEY.";
-    case "vertex":
-      return "Vertex AI project is missing. Set GOOGLE_CLOUD_PROJECT (or GCLOUD_PROJECT) and ensure application default credentials are configured.";
-    case "anthropic": {
-      return "Anthropic API key is missing. Set ANTHROPIC_API_KEY.";
-    }
-    case "openai": {
-      return "OpenAI API key is missing. Set OPENAI_API_KEY.";
-    }
-  }
-}
-async function getProviderModel(provider, modelId) {
-  switch (provider) {
-    case "google": {
-      const apiKey = readFirstEnvValue(process.env, GEMINI_API_KEY_ENV_VARS);
-      if (!apiKey) {
-        throw new Error(missingProviderCredentialsMessage(provider));
-      }
-      const { createGoogleGenerativeAI } = await import("@ai-sdk/google");
-      const google = createGoogleGenerativeAI({ apiKey });
-      return google(modelId);
-    }
-    case "vertex": {
-      const project = readFirstEnvValue(process.env, VERTEX_PROJECT_ENV_VARS);
-      if (!project) {
-        throw new Error(missingProviderCredentialsMessage(provider));
-      }
-      const { createVertex } = await import("@ai-sdk/google-vertex");
-      const vertex = createVertex({
-        project,
-        location: process.env.GOOGLE_CLOUD_LOCATION || "global"
-      });
-      return vertex(modelId);
-    }
-    case "anthropic": {
-      const apiKey = process.env.ANTHROPIC_API_KEY?.trim();
-      if (!apiKey) {
-        throw new Error(missingProviderCredentialsMessage(provider));
-      }
-      const { createAnthropic } = await import("@ai-sdk/anthropic");
-      const anthropic = createAnthropic({ apiKey });
-      return anthropic(modelId);
-    }
-    case "openai": {
-      const apiKey = process.env.OPENAI_API_KEY?.trim();
-      if (!apiKey) {
-        throw new Error(missingProviderCredentialsMessage(provider));
-      }
-      const { createOpenAI } = await import("@ai-sdk/openai");
-      const openai = createOpenAI({ apiKey });
-      return openai(modelId);
-    }
-  }
-}
-function convertUserContentParts(parts) {
-  return parts.map((part) => {
-    if (part.type === "text") {
-      return { type: "text", text: part.text };
-    }
-    return {
-      type: "image",
-      image: part.image,
-      ...part.mediaType ? { mediaType: part.mediaType } : {}
-    };
-  });
-}
-function convertAssistantContentParts(parts) {
-  return parts.filter((part) => part.type === "text").map((part) => ({ type: "text", text: part.text }));
-}
-function convertMessages(messages) {
-  return messages.map((msg) => {
-    if (msg.role === "user") {
-      if (typeof msg.content === "string") {
-        return { role: "user", content: msg.content };
-      }
-      return {
-        role: "user",
-        content: convertUserContentParts(msg.content)
-      };
-    }
-    if (typeof msg.content === "string") {
-      return { role: "assistant", content: msg.content };
-    }
-    return {
-      role: "assistant",
-      content: convertAssistantContentParts(msg.content)
-    };
-  });
-}
-function createLLMClient(model) {
-  const { provider, modelId } = parseModel(model);
-  let modelPromise = null;
-  const getModel = () => {
-    modelPromise ??= getProviderModel(provider, modelId);
-    return modelPromise;
-  };
-  return {
-    async generateObject(opts) {
-      const aiModel = await getModel();
-      const result = await (0, import_ai.generateObject)({
-        model: aiModel,
-        prompt: opts.prompt,
-        schema: opts.schema,
-        temperature: opts.temperature ?? 0
-      });
-      return result.object;
-    },
-    async generateObjectFromMessages(opts) {
-      const aiModel = await getModel();
-      const result = await (0, import_ai.generateObject)({
-        model: aiModel,
-        messages: convertMessages(opts.messages),
-        schema: opts.schema,
-        temperature: opts.temperature ?? 0
-      });
-      return result.object;
-    }
-  };
-}
-// Annotate the CommonJS export names for ESM import in node:
-0 && (module.exports = {
-  createLLMClient,
-  hasProviderCredentials,
-  missingProviderCredentialsMessage,
-  parseModel
-});

package/dist/shared/llm/client.d.cts

@@ -1,13 +0,0 @@
-import { LLMClient } from './types.cjs';
-import 'zod';
-
-type Provider = "google" | "vertex" | "anthropic" | "openai";
-declare function parseModel(model: string): {
-    provider: Provider;
-    modelId: string;
-};
-declare function hasProviderCredentials(provider: Provider, env?: NodeJS.ProcessEnv): boolean;
-declare function missingProviderCredentialsMessage(provider: Provider): string;
-declare function createLLMClient(model: string): LLMClient;
-
-export { type Provider, createLLMClient, hasProviderCredentials, missingProviderCredentialsMessage, parseModel };

package/dist/shared/llm/index.cjs

@@ -1,31 +0,0 @@
-"use strict";
-var __defProp = Object.defineProperty;
-var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __export = (target, all) => {
-  for (var name in all)
-    __defProp(target, name, { get: all[name], enumerable: true });
-};
-var __copyProps = (to, from, except, desc) => {
-  if (from && typeof from === "object" || typeof from === "function") {
-    for (let key of __getOwnPropNames(from))
-      if (!__hasOwnProp.call(to, key) && key !== except)
-        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
-  }
-  return to;
-};
-var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
-var llm_exports = {};
-__export(llm_exports, {
-  createLLMClient: () => import_client.createLLMClient,
-  createLLMClientFromModel: () => import_ai_sdk_adapter.createLLMClientFromModel
-});
-module.exports = __toCommonJS(llm_exports);
-var import_client = require("./client.js");
-var import_ai_sdk_adapter = require("./ai-sdk-adapter.js");
-// Annotate the CommonJS export names for ESM import in node:
-0 && (module.exports = {
-  createLLMClient,
-  createLLMClientFromModel
-});

package/dist/shared/llm/index.d.cts

@@ -1,5 +0,0 @@
-export { LLMClient, Message, MessageContentPart } from './types.cjs';
-export { createLLMClient } from './client.cjs';
-export { createLLMClientFromModel } from './ai-sdk-adapter.cjs';
-import 'zod';
-import 'ai';

package/dist/shared/llm/types.cjs

@@ -1,16 +0,0 @@
-"use strict";
-var __defProp = Object.defineProperty;
-var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __copyProps = (to, from, except, desc) => {
-  if (from && typeof from === "object" || typeof from === "function") {
-    for (let key of __getOwnPropNames(from))
-      if (!__hasOwnProp.call(to, key) && key !== except)
-        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
-  }
-  return to;
-};
-var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
-var types_exports = {};
-module.exports = __toCommonJS(types_exports);

package/dist/shared/llm/types.d.cts

@@ -1,67 +0,0 @@
-import z from 'zod';
-
-type MessageContentPart = {
-    type: "text";
-    text: string;
-} | {
-    type: "image";
-    image: string | Uint8Array;
-    mediaType?: string;
-};
-type Message = {
-    role: "user" | "assistant";
-    content: string | MessageContentPart[];
-};
-/**
- * Pluggable LLM client interface.
- *
- * Users provide their own implementation backed by any LLM provider
- * (OpenAI, Anthropic, etc.). Libretto uses this interface for AI extraction,
- * recovery agents, and error detection.
- *
- * **Error handling:** implementations should throw on failure rather than
- * returning sentinel values (e.g. `null` or `undefined`). Libretto relies
- * on exceptions to trigger retry/recovery logic.
- *
- * A ready-made adapter for the Vercel AI SDK is available via
- * {@link createLLMClientFromModel} in `libretto/llm`.
- */
-interface LLMClient {
-    /**
-     * Generate a structured object from a single text prompt.
-     *
-     * The underlying model **must** support structured / JSON output so that
-     * the response can be parsed and validated against the provided Zod schema.
-     *
-     * @param opts.prompt - The text prompt sent to the model.
-     * @param opts.schema - A Zod schema describing the expected response shape.
-     * @param opts.temperature - Sampling temperature (default chosen by implementation, typically 0).
-     * @returns The parsed object matching the schema.
-     * @throws On LLM or parsing failure.
-     */
-    generateObject<T extends z.ZodType>(opts: {
-        prompt: string;
-        schema: T;
-        temperature?: number;
-    }): Promise<z.output<T>>;
-    /**
-     * Generate a structured object from a conversation-style message array.
-     *
-     * Messages may contain **image content** (base64 data URIs via
-     * {@link MessageContentPart}), so the backing model must support
-     * vision / multimodal input when images are present.
-     *
-     * @param opts.messages - Ordered list of user/assistant messages, potentially multimodal.
-     * @param opts.schema - A Zod schema describing the expected response shape.
-     * @param opts.temperature - Sampling temperature (default chosen by implementation, typically 0).
-     * @returns The parsed object matching the schema.
-     * @throws On LLM or parsing failure.
-     */
-    generateObjectFromMessages<T extends z.ZodType>(opts: {
-        messages: Message[];
-        schema: T;
-        temperature?: number;
-    }): Promise<z.output<T>>;
-}
-
-export type { LLMClient, Message, MessageContentPart };

package/dist/shared/logger/index.cjs

@@ -1,37 +0,0 @@
-"use strict";
-var __defProp = Object.defineProperty;
-var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __export = (target, all) => {
-  for (var name in all)
-    __defProp(target, name, { get: all[name], enumerable: true });
-};
-var __copyProps = (to, from, except, desc) => {
-  if (from && typeof from === "object" || typeof from === "function") {
-    for (let key of __getOwnPropNames(from))
-      if (!__hasOwnProp.call(to, key) && key !== except)
-        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
-  }
-  return to;
-};
-var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
-var logger_exports = {};
-__export(logger_exports, {
-  Logger: () => import_logger.Logger,
-  createFileLogSink: () => import_sinks.createFileLogSink,
-  defaultLogger: () => import_logger.defaultLogger,
-  jsonlConsoleSink: () => import_sinks.jsonlConsoleSink,
-  prettyConsoleSink: () => import_sinks.prettyConsoleSink
-});
-module.exports = __toCommonJS(logger_exports);
-var import_logger = require("./logger.js");
-var import_sinks = require("./sinks.js");
-// Annotate the CommonJS export names for ESM import in node:
-0 && (module.exports = {
-  Logger,
-  createFileLogSink,
-  defaultLogger,
-  jsonlConsoleSink,
-  prettyConsoleSink
-});

package/dist/shared/logger/index.d.cts

@@ -1,2 +0,0 @@
-export { LogOptions, Logger, LoggerApi, LoggerSink, MinimalLogger, defaultLogger } from './logger.cjs';
-export { createFileLogSink, jsonlConsoleSink, prettyConsoleSink } from './sinks.cjs';