libretto 0.2.6 → 0.3.0

package/dist/shared/llm/client.cjs

@@ -1,139 +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 client_exports = {};
-__export(client_exports, {
-  createLLMClient: () => createLLMClient
-});
-module.exports = __toCommonJS(client_exports);
-var import_google_vertex = require("@ai-sdk/google-vertex");
-var import_anthropic = require("@ai-sdk/anthropic");
-var import_openai = require("@ai-sdk/openai");
-var import_ai = require("ai");
-function parseModel(model) {
-  const slashIndex = model.indexOf("/");
-  if (slashIndex === -1) {
-    throw new Error(
-      `Invalid model string "${model}". Expected format: "provider/model-id" (e.g. "google/gemini-3-flash-preview").`
-    );
-  }
-  const provider = model.slice(0, slashIndex);
-  const modelId = model.slice(slashIndex + 1);
-  if (!["google", "anthropic", "openai"].includes(provider)) {
-    throw new Error(
-      `Unsupported provider "${provider}". Supported providers: google, anthropic, openai.`
-    );
-  }
-  return { provider, modelId };
-}
-function getProviderModel(provider, modelId) {
-  switch (provider) {
-    case "google": {
-      const project = process.env.GOOGLE_CLOUD_PROJECT || process.env.GCLOUD_PROJECT;
-      if (!project) {
-        throw new Error(
-          "Missing GCP project for Vertex AI. Set GOOGLE_CLOUD_PROJECT environment variable and ensure application default credentials are configured (gcloud auth application-default login)."
-        );
-      }
-      const vertex = (0, import_google_vertex.createVertex)({
-        project,
-        location: process.env.GOOGLE_CLOUD_LOCATION || "global"
-      });
-      return vertex(modelId);
-    }
-    case "anthropic": {
-      const apiKey = process.env.ANTHROPIC_API_KEY;
-      if (!apiKey) {
-        throw new Error(
-          "Missing API key for Anthropic. Set ANTHROPIC_API_KEY environment variable."
-        );
-      }
-      const anthropic = (0, import_anthropic.createAnthropic)({ apiKey });
-      return anthropic(modelId);
-    }
-    case "openai": {
-      const apiKey = process.env.OPENAI_API_KEY;
-      if (!apiKey) {
-        throw new Error(
-          "Missing API key for OpenAI. Set OPENAI_API_KEY environment variable."
-        );
-      }
-      const openai = (0, import_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 };
-  });
-}
-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);
-  const aiModel = getProviderModel(provider, modelId);
-  return {
-    async generateObject(opts) {
-      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 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
-});

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

@@ -1,6 +0,0 @@
-import { LLMClient } from './types.cjs';
-import 'zod';
-
-declare function createLLMClient(model: string): LLMClient;
-
-export { createLLMClient };

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

@@ -1,6 +0,0 @@
-import { LLMClient } from './types.js';
-import 'zod';
-
-declare function createLLMClient(model: string): LLMClient;
-
-export { createLLMClient };

package/dist/shared/llm/client.js

@@ -1,115 +0,0 @@
-import { createVertex } from "@ai-sdk/google-vertex";
-import { createAnthropic } from "@ai-sdk/anthropic";
-import { createOpenAI } from "@ai-sdk/openai";
-import { generateObject } from "ai";
-function parseModel(model) {
-  const slashIndex = model.indexOf("/");
-  if (slashIndex === -1) {
-    throw new Error(
-      `Invalid model string "${model}". Expected format: "provider/model-id" (e.g. "google/gemini-3-flash-preview").`
-    );
-  }
-  const provider = model.slice(0, slashIndex);
-  const modelId = model.slice(slashIndex + 1);
-  if (!["google", "anthropic", "openai"].includes(provider)) {
-    throw new Error(
-      `Unsupported provider "${provider}". Supported providers: google, anthropic, openai.`
-    );
-  }
-  return { provider, modelId };
-}
-function getProviderModel(provider, modelId) {
-  switch (provider) {
-    case "google": {
-      const project = process.env.GOOGLE_CLOUD_PROJECT || process.env.GCLOUD_PROJECT;
-      if (!project) {
-        throw new Error(
-          "Missing GCP project for Vertex AI. Set GOOGLE_CLOUD_PROJECT environment variable and ensure application default credentials are configured (gcloud auth application-default login)."
-        );
-      }
-      const vertex = createVertex({
-        project,
-        location: process.env.GOOGLE_CLOUD_LOCATION || "global"
-      });
-      return vertex(modelId);
-    }
-    case "anthropic": {
-      const apiKey = process.env.ANTHROPIC_API_KEY;
-      if (!apiKey) {
-        throw new Error(
-          "Missing API key for Anthropic. Set ANTHROPIC_API_KEY environment variable."
-        );
-      }
-      const anthropic = createAnthropic({ apiKey });
-      return anthropic(modelId);
-    }
-    case "openai": {
-      const apiKey = process.env.OPENAI_API_KEY;
-      if (!apiKey) {
-        throw new Error(
-          "Missing API key for OpenAI. Set OPENAI_API_KEY environment variable."
-        );
-      }
-      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 };
-  });
-}
-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);
-  const aiModel = getProviderModel(provider, modelId);
-  return {
-    async generateObject(opts) {
-      const result = await generateObject({
-        model: aiModel,
-        prompt: opts.prompt,
-        schema: opts.schema,
-        temperature: opts.temperature ?? 0
-      });
-      return result.object;
-    },
-    async generateObjectFromMessages(opts) {
-      const result = await generateObject({
-        model: aiModel,
-        messages: convertMessages(opts.messages),
-        schema: opts.schema,
-        temperature: opts.temperature ?? 0
-      });
-      return result.object;
-    }
-  };
-}
-export {
-  createLLMClient
-};

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/index.d.ts

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

package/dist/shared/llm/index.js

@@ -1,6 +0,0 @@
-import { createLLMClient } from "./client.js";
-import { createLLMClientFromModel } from "./ai-sdk-adapter.js";
-export {
-  createLLMClient,
-  createLLMClientFromModel
-};

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,66 +0,0 @@
-import z from 'zod';
-
-type MessageContentPart = {
-    type: "text";
-    text: string;
-} | {
-    type: "image";
-    image: 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.infer<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.infer<T>>;
-}
-
-export type { LLMClient, Message, MessageContentPart };

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

@@ -1,66 +0,0 @@
-import z from 'zod';
-
-type MessageContentPart = {
-    type: "text";
-    text: string;
-} | {
-    type: "image";
-    image: 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.infer<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.infer<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';

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

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

package/dist/shared/logger/index.js

@@ -1,13 +0,0 @@
-import { Logger, defaultLogger } from "./logger.js";
-import {
-  createFileLogSink,
-  prettyConsoleSink,
-  jsonlConsoleSink
-} from "./sinks.js";
-export {
-  Logger,
-  createFileLogSink,
-  defaultLogger,
-  jsonlConsoleSink,
-  prettyConsoleSink
-};