@brotu/ai 0.2.0 → 0.4.0

package/README.md

@@ -1,20 +1,20 @@
 <p align="center">
   <picture>
-    <source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/Zorbi-Tech/brotu-sdk/main/docs/assets/logo.svg">
-    <img src="https://raw.githubusercontent.com/Zorbi-Tech/brotu-sdk/main/docs/assets/logo-black.svg" alt="Brotu" width="280">
+    <source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/Zorbi-Tech/brotu/main/docs/assets/logo.svg">
+    <img src="https://raw.githubusercontent.com/Zorbi-Tech/brotu/main/docs/assets/logo-black.svg" alt="Brotu" width="280">
   </picture>
 </p>
 
 <p align="center">
   <strong>One TypeScript client for video, image, speech, text and vendor extras.</strong><br>
-  You bring the keys. Each call hits the vendor's own API.
+  Your Brotu key. Vendor keys generate on the vendor.
 </p>
 
 <p align="center">
   <a href="https://www.npmjs.com/package/@brotu/ai"><img alt="npm version" src="https://img.shields.io/npm/v/@brotu/ai?color=ef5e28"></a>
   <a href="https://www.npmjs.com/package/@brotu/ai"><img alt="npm downloads" src="https://img.shields.io/npm/dm/@brotu/ai?color=ef5e28&label=downloads"></a>
   <a href="https://www.npmjs.com/package/@brotu/ai"><img alt="npm totals" src="https://img.shields.io/npm/dt/@brotu/ai?color=111&label=total"></a>
-  <a href="https://github.com/Zorbi-Tech/brotu-sdk/blob/main/LICENSE"><img alt="MIT" src="https://img.shields.io/npm/l/@brotu/ai?color=111"></a>
+  <a href="https://github.com/Zorbi-Tech/brotu/blob/main/LICENSE"><img alt="MIT" src="https://img.shields.io/npm/l/@brotu/ai?color=111"></a>
 </p>
 
 <p align="center">
@@ -23,7 +23,9 @@
   <a href="https://x.com/brotuApp">@brotuApp</a>
 </p>
 
-Kling, Seedance, Wan, Veo, Gemini, gpt-image and ElevenLabs all speak different HTTP. This package is one `brotuClient` in front of them. No proxy.
+Kling, Seedance, Wan, Veo, Gemini, gpt-image and ElevenLabs all speak different HTTP. This package is one `brotuClient` in front of them.
+
+Get your key (`brotu_sk_…`) at [brotu.app](https://brotu.app). Pass a vendor key you already have and that model hits the vendor. Everything else generates on Brotu.
 
 97 models: 37 video, 29 image, 12 speech, 19 text. Full table in [CATALOG.md](./CATALOG.md). That file is generated from the catalog, so it cannot drift from what the code supports.
 
@@ -47,6 +49,7 @@ pnpm add @brotu/ai
 import { brotuClient } from "@brotu/ai";
 
 const ai = brotuClient({
+  apiKey: process.env.BROTU_API_KEY!, // brotu_sk_… from https://brotu.app
   providers: {
     kling: { apiKey: process.env.KLING_API_KEY! },
     byteplus: { apiKey: process.env.ARK_API_KEY! },
@@ -55,10 +58,14 @@ const ai = brotuClient({
     qwen: { apiKey: process.env.QWEN_API_KEY! },
     elevenlabs: { apiKey: process.env.ELEVENLABS_API_KEY! },
   },
+  webhook: {
+    url: "https://my.app/hooks/brotu",
+    secret: process.env.BROTU_WEBHOOK_SECRET,
+  },
 });
 ```
 
-Only configured providers appear in `ai.models()`.
+Your Brotu key opens the catalog. A vendor key, when you have one, generates on that vendor.
 
 Every public call returns `{ data, error }`. `data` is unusable until you narrow on `error`.
 
@@ -69,6 +76,7 @@ Every public call returns `{ data, error }`. `data` is unusable until you narrow
 | `ai.text` | `submit` / `generate` |
 | `ai.audio` | `submit` / `generate` |
 | `ai.jobs` | `poll` / `wait` |
+| `ai.webhook` | `set` / `clear` / `get` |
 | `ai.estimateCost` | units, and USD when verified |
 | `ai.kling` | `motionControl`, `omniVideo`, `avatar`, `outpainting`, `imageOmni` |
 | `ai.google` | `omniVideo` (conversational refine) |
@@ -145,6 +153,10 @@ ElevenLabs: you must pass `voice`. There is no default.
 
 Realtime / Live WebSocket models are not on this surface.
 
+## CLI
+
+The terminal lives in [`../../cli`](../../cli) (`@brotu/cli`). This package is the library only.
+
 ## Jobs
 
 ```ts
@@ -156,6 +168,41 @@ if (result === undefined && snapshot?.status === "pending") {
 }
 ```
 
+## Webhook
+
+Register a URL on the client. When `generate`, `jobs.wait` or a terminal `jobs.poll` settles, the SDK POSTs the result there. A down hook never fails the generation.
+
+```ts
+ai.webhook.set("https://my.app/hooks/brotu");
+ai.webhook.clear();
+```
+
+Per request, if one generation should go somewhere else:
+
+```ts
+await ai.video.submit({
+  model: "kling/v2-6",
+  prompt: "a cat",
+  webhook: "https://my.app/hooks/this-one",
+});
+```
+
+The POST is JSON. Check `x-brotu-event` and, if you set a secret, `x-brotu-webhook-secret`.
+
+```json
+{
+  "event": "generation.succeeded",
+  "jobId": "task-1",
+  "provider": "kling",
+  "model": "kling/v2-6",
+  "kind": "video",
+  "outputs": [{ "url": "https://…", "mimeType": "video/mp4" }],
+  "completedAt": "2026-08-16T12:00:00.000Z"
+}
+```
+
+`generation.failed` carries `error: { code, message }` and no outputs. Timeouts and routing errors do not fire the hook.
+
 Error codes: `unknown_model`, `missing_key`, `unsupported_provider`, `invalid_request`, `provider_error`, `timeout`.
 
 ## Motion control, avatars, omni

package/dist/adapters/brotu.adapter.d.ts

@@ -0,0 +1,46 @@
+import { type Job, type JobSnapshot } from "../lib/jobs";
+import { type AudioGenerationParams, type ContentGeneratorPort, type CostEstimate, type GenerationParams, type GenerationResult, type GenerationType, type ImageGenerationParams, type TextGenerationParams, type VideoGenerationParams } from "../ports/content-generator.port";
+export interface BrotuAdapterOptions {
+    apiKey: string;
+    /** Origin only, no trailing slash. Defaults to https://api.brotu.app */
+    apiUrl?: string;
+    workspaceId?: string;
+    maxPollAttempts?: number;
+}
+/**
+ * SDK catalog ids that do not match the platform catalog. Unlisted ids are
+ * sent as-is — gpt-image-2 and bytedance/seedance-2-5 already agree.
+ */
+declare const PLATFORM_MODEL_IDS: Record<string, string>;
+export declare class BrotuAdapter implements ContentGeneratorPort {
+    private readonly opts;
+    readonly providerName = "brotu";
+    readonly supportedTypes: GenerationType[];
+    private workspaceIdCache?;
+    constructor(opts: BrotuAdapterOptions);
+    private get origin();
+    private headers;
+    private workspaceId;
+    private studioPath;
+    private request;
+    private platformModel;
+    private startGeneration;
+    private imageBody;
+    private videoBody;
+    private run;
+    completeJob(job: Job): Promise<JobSnapshot>;
+    private workspaceFromPoll;
+    generateImage(params: ImageGenerationParams): Promise<GenerationResult>;
+    generateVideo(params: VideoGenerationParams): Promise<GenerationResult>;
+    generateText(params: TextGenerationParams): Promise<GenerationResult>;
+    generateAudio(params: AudioGenerationParams): Promise<GenerationResult>;
+    estimateCost(type: GenerationType, params: GenerationParams): Promise<CostEstimate>;
+    supportsModel(): boolean;
+    getAvailableModels(): {
+        id: string;
+        name: string;
+        type: GenerationType;
+    }[];
+}
+export { PLATFORM_MODEL_IDS };
+//# sourceMappingURL=brotu.adapter.d.ts.map

package/dist/adapters/brotu.adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"brotu.adapter.d.ts","sourceRoot":"","sources":["../../src/adapters/brotu.adapter.ts"],"names":[],"mappings":"AAAA,OAAO,EAEN,KAAK,GAAG,EACR,KAAK,WAAW,EAEhB,MAAM,aAAa,CAAC;AACrB,OAAO,EACN,KAAK,qBAAqB,EAC1B,KAAK,oBAAoB,EACzB,KAAK,YAAY,EAEjB,KAAK,gBAAgB,EACrB,KAAK,gBAAgB,EACrB,KAAK,cAAc,EACnB,KAAK,qBAAqB,EAC1B,KAAK,oBAAoB,EACzB,KAAK,qBAAqB,EAC1B,MAAM,iCAAiC,CAAC;AAGzC,MAAM,WAAW,mBAAmB;IACnC,MAAM,EAAE,MAAM,CAAC;IACf,wEAAwE;IACxE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,eAAe,CAAC,EAAE,MAAM,CAAC;CACzB;AAMD;;;GAGG;AACH,QAAA,MAAM,kBAAkB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAO9C,CAAC;AAuBF,qBAAa,YAAa,YAAW,oBAAoB;IAM5C,OAAO,CAAC,QAAQ,CAAC,IAAI;IALjC,QAAQ,CAAC,YAAY,WAAW;IAChC,QAAQ,CAAC,cAAc,EAAE,cAAc,EAAE,CAAsB;IAE/D,OAAO,CAAC,gBAAgB,CAAC,CAAS;IAElC,YAA6B,IAAI,EAAE,mBAAmB,EAAI;IAE1D,OAAO,KAAK,MAAM,GAEjB;IAED,OAAO,CAAC,OAAO;YAOD,WAAW;IAiBzB,OAAO,CAAC,UAAU;YAKJ,OAAO;IAyBrB,OAAO,CAAC,aAAa;YAIP,eAAe;IAwB7B,OAAO,CAAC,SAAS;IAgBjB,OAAO,CAAC,SAAS;YAqBH,GAAG;IA4DX,WAAW,CAAC,GAAG,EAAE,GAAG,GAAG,OAAO,CAAC,WAAW,CAAC,CAgChD;IAED,OAAO,CAAC,iBAAiB;IAUzB,aAAa,CAAC,MAAM,EAAE,qBAAqB,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAEtE;IAED,aAAa,CAAC,MAAM,EAAE,qBAAqB,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAEtE;IAEK,YAAY,CAAC,MAAM,EAAE,oBAAoB,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAU1E;IAEK,aAAa,CAAC,MAAM,EAAE,qBAAqB,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAU5E;IAEK,YAAY,CACjB,IAAI,EAAE,cAAc,EACpB,MAAM,EAAE,gBAAgB,GACtB,OAAO,CAAC,YAAY,CAAC,CAuDvB;IAED,aAAa,IAAI,OAAO,CAEvB;IAED,kBAAkB,IAAI;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,cAAc,CAAA;KAAE,EAAE,CAEzE;CACD;AA2BD,OAAO,EAAE,kBAAkB,EAAE,CAAC"}

package/dist/catalog.cjs

@@ -20,6 +20,7 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 // src/catalog.ts
 var catalog_exports = {};
 __export(catalog_exports, {
+  DEFAULT_BROTU_API_URL: () => DEFAULT_BROTU_API_URL,
   getAvailableModels: () => getAvailableModels,
   getModel: () => getModel,
   getModels: () => getModels,
@@ -995,8 +996,16 @@ var PROVIDER_BASE_URLS = {
   elevenlabs: "https://api.elevenlabs.io",
   google: "https://generativelanguage.googleapis.com",
   openai: "https://api.openai.com",
-  qwen: "https://dashscope-intl.aliyuncs.com"
+  qwen: "https://dashscope-intl.aliyuncs.com",
+  brotu: "https://api.brotu.app"
 };
+var DEFAULT_BROTU_API_URL = PROVIDER_BASE_URLS.brotu;
+function vendorProviders(options) {
+  return options.providers ?? {};
+}
+function brotuApiKey(options) {
+  return options.apiKey?.trim() || void 0;
+}
 var BUILT_IN = [
   ...KLING_CATALOG,
   ...KLING_AUDIO_CATALOG,
@@ -1052,28 +1061,41 @@ function resolveProvider(modelId, options) {
       `Model "${modelId}" declares no provider, so nothing knows how to run it.`
     );
   }
-  const configured = options.providers[id];
-  if (!configured) {
-    const owned = Object.keys(options.providers).join(", ") || "none";
-    throw new Error(
-      `Model "${modelId}" runs on "${id}", but no API key was given for it (configured: ${owned}).`
-    );
+  const configured = vendorProviders(options)[id];
+  if (configured) {
+    const baseUrl = configured.baseUrl ?? PROVIDER_BASE_URLS[id];
+    if (!baseUrl) {
+      throw new Error(
+        `Provider "${id}" has no known base URL \u2014 pass providers.${id}.baseUrl.`
+      );
+    }
+    return { id, apiKey: configured.apiKey, baseUrl: baseUrl.replace(/\/$/, "") };
   }
-  const baseUrl = configured.baseUrl ?? PROVIDER_BASE_URLS[id];
-  if (!baseUrl) {
-    throw new Error(
-      `Provider "${id}" has no known base URL \u2014 pass providers.${id}.baseUrl.`
-    );
+  const platformKey = brotuApiKey(options);
+  if (platformKey) {
+    return {
+      id: "brotu",
+      apiKey: platformKey,
+      baseUrl: (options.apiUrl ?? DEFAULT_BROTU_API_URL).replace(/\/$/, "")
+    };
   }
-  return { id, apiKey: configured.apiKey, baseUrl: baseUrl.replace(/\/$/, "") };
+  const owned = Object.keys(vendorProviders(options)).join(", ") || "none";
+  throw new Error(
+    `Model "${modelId}" runs on "${id}", but no API key was given for it (configured: ${owned}). Pass a Brotu key to generate on the platform.`
+  );
 }
 function getAvailableModels(options) {
+  if (brotuApiKey(options)) {
+    return catalog.filter((model) => Boolean(model.provider));
+  }
+  const vendors = vendorProviders(options);
   return catalog.filter(
-    (model) => model.provider && model.provider in options.providers
+    (model) => model.provider && model.provider in vendors
   );
 }
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
+  DEFAULT_BROTU_API_URL,
   getAvailableModels,
   getModel,
   getModels,

package/dist/catalog.d.ts

@@ -1,5 +1,6 @@
 import type { AIModelConfig } from "./constants/model.types";
 import type { BrotuAIOptions, ResolvedProvider } from "./types";
+export declare const DEFAULT_BROTU_API_URL: string;
 /**
  * Add models, or patch built-in ones, matching on id.
  *

package/dist/catalog.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"catalog.d.ts","sourceRoot":"","sources":["../src/catalog.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAU7D,OAAO,KAAK,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAkChE;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,MAAM,GAAE,aAAa,EAAO,GAAG,IAAI,CAUjE;AAED,0EAA0E;AAC1E,wBAAgB,YAAY,IAAI,IAAI,CAGnC;AAED,wBAAgB,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS,CAEnE;AAED,wBAAgB,SAAS,IAAI,aAAa,EAAE,CAE3C;AAED,wBAAgB,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAEjD;AAED,wDAAwD;AACxD,wBAAgB,YAAY,IAAI,MAAM,EAAE,CAQvC;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAC9B,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,cAAc,GACrB,gBAAgB,CA6BlB;AAED,wEAAwE;AACxE,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,cAAc,GAAG,aAAa,EAAE,CAI3E"}
+{"version":3,"file":"catalog.d.ts","sourceRoot":"","sources":["../src/catalog.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAU7D,OAAO,KAAK,EAAE,cAAc,EAAkB,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAgBhF,eAAO,MAAM,qBAAqB,QAA2B,CAAC;AA+B9D;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,MAAM,GAAE,aAAa,EAAO,GAAG,IAAI,CAUjE;AAED,0EAA0E;AAC1E,wBAAgB,YAAY,IAAI,IAAI,CAGnC;AAED,wBAAgB,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS,CAEnE;AAED,wBAAgB,SAAS,IAAI,aAAa,EAAE,CAE3C;AAED,wBAAgB,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAEjD;AAED,wDAAwD;AACxD,wBAAgB,YAAY,IAAI,MAAM,EAAE,CAQvC;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAC9B,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,cAAc,GACrB,gBAAgB,CAqClB;AAED,wEAAwE;AACxE,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,cAAc,GAAG,aAAa,EAAE,CAQ3E"}

package/dist/catalog.js

@@ -1,4 +1,5 @@
 import {
+  DEFAULT_BROTU_API_URL,
   getAvailableModels,
   getModel,
   getModels,
@@ -7,8 +8,9 @@ import {
   registerModels,
   resetCatalog,
   resolveProvider
-} from "./chunk-PL534BFN.js";
+} from "./chunk-QOWHHKSI.js";
 export {
+  DEFAULT_BROTU_API_URL,
   getAvailableModels,
   getModel,
   getModels,

package/dist/{chunk-PL534BFN.js → chunk-QOWHHKSI.js}

@@ -1159,8 +1159,16 @@ var PROVIDER_BASE_URLS = {
   elevenlabs: "https://api.elevenlabs.io",
   google: "https://generativelanguage.googleapis.com",
   openai: "https://api.openai.com",
-  qwen: "https://dashscope-intl.aliyuncs.com"
+  qwen: "https://dashscope-intl.aliyuncs.com",
+  brotu: "https://api.brotu.app"
 };
+var DEFAULT_BROTU_API_URL = PROVIDER_BASE_URLS.brotu;
+function vendorProviders(options) {
+  return options.providers ?? {};
+}
+function brotuApiKey(options) {
+  return options.apiKey?.trim() || void 0;
+}
 var BUILT_IN = [
   ...KLING_CATALOG,
   ...KLING_AUDIO_CATALOG,
@@ -1216,24 +1224,36 @@ function resolveProvider(modelId, options) {
       `Model "${modelId}" declares no provider, so nothing knows how to run it.`
     );
   }
-  const configured = options.providers[id];
-  if (!configured) {
-    const owned = Object.keys(options.providers).join(", ") || "none";
-    throw new Error(
-      `Model "${modelId}" runs on "${id}", but no API key was given for it (configured: ${owned}).`
-    );
+  const configured = vendorProviders(options)[id];
+  if (configured) {
+    const baseUrl = configured.baseUrl ?? PROVIDER_BASE_URLS[id];
+    if (!baseUrl) {
+      throw new Error(
+        `Provider "${id}" has no known base URL \u2014 pass providers.${id}.baseUrl.`
+      );
+    }
+    return { id, apiKey: configured.apiKey, baseUrl: baseUrl.replace(/\/$/, "") };
   }
-  const baseUrl = configured.baseUrl ?? PROVIDER_BASE_URLS[id];
-  if (!baseUrl) {
-    throw new Error(
-      `Provider "${id}" has no known base URL \u2014 pass providers.${id}.baseUrl.`
-    );
+  const platformKey = brotuApiKey(options);
+  if (platformKey) {
+    return {
+      id: "brotu",
+      apiKey: platformKey,
+      baseUrl: (options.apiUrl ?? DEFAULT_BROTU_API_URL).replace(/\/$/, "")
+    };
   }
-  return { id, apiKey: configured.apiKey, baseUrl: baseUrl.replace(/\/$/, "") };
+  const owned = Object.keys(vendorProviders(options)).join(", ") || "none";
+  throw new Error(
+    `Model "${modelId}" runs on "${id}", but no API key was given for it (configured: ${owned}). Pass a Brotu key to generate on the platform.`
+  );
 }
 function getAvailableModels(options) {
+  if (brotuApiKey(options)) {
+    return catalog.filter((model) => Boolean(model.provider));
+  }
+  const vendors = vendorProviders(options);
   return catalog.filter(
-    (model) => model.provider && model.provider in options.providers
+    (model) => model.provider && model.provider in vendors
   );
 }
 
@@ -1266,6 +1286,7 @@ export {
   QWEN_AUDIO_MODELS,
   QWEN_TEXT_MODELS,
   QWEN_CATALOG,
+  DEFAULT_BROTU_API_URL,
   registerModels,
   resetCatalog,
   getModel,

package/dist/client.d.ts

@@ -2,6 +2,7 @@ import { getModel } from "./catalog";
 import type { AIModelConfig } from "./constants/model.types";
 import { type AIError, type Generation, type Result } from "./helpers/result";
 import { type Job, type JobSnapshot } from "./lib/jobs";
+import { type WebhookConfig } from "./lib/webhook";
 import type { AudioGenerationParams, CostEstimate, GenerationOutput, GenerationParams, GenerationType, ImageGenerationParams, TextGenerationParams, VideoGenerationParams } from "./ports/content-generator.port";
 import { type AvatarInput, type ImageOmniInput, type MotionControlInput, type OmniVideoInput, type OutpaintingInput } from "./providers/kling.models";
 import type { BrotuAIOptions } from "./types";
@@ -35,6 +36,15 @@ export interface BrotuAI {
             timeoutMs?: number;
         }): Promise<Result<Generation>>;
     };
+    /**
+     * URL the client POSTs when a generation settles. Register at construction
+     * (`webhook:`) or here later. A down hook never fails the generation.
+     */
+    webhook: {
+        set(value: string | WebhookConfig): void;
+        clear(): void;
+        get(): WebhookConfig | undefined;
+    };
     /**
      * Google capabilities with no portable equivalent. Present only when a google
      * key is configured.
@@ -71,7 +81,7 @@ export interface BrotuAI {
         /** Compose or edit across up to ten references. */
         imageOmni(input: ImageOmniInput): Promise<Result<Job>>;
     };
-    /** Models runnable with the keys given to this client. */
+    /** Models this client can run. */
     models(): AIModelConfig[];
     /**
      * What this generation will be billed for, before running it. Always reports

package/dist/client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAOA,OAAO,EAEN,QAAQ,EAGR,MAAM,WAAW,CAAC;AACnB,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAC7D,OAAO,EACN,KAAK,OAAO,EAGZ,KAAK,UAAU,EAEf,KAAK,MAAM,EACX,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAEN,KAAK,GAAG,EACR,KAAK,WAAW,EAEhB,MAAM,YAAY,CAAC;AAEpB,OAAO,EAGN,KAAK,aAAa,EAGlB,MAAM,eAAe,CAAC;AACvB,OAAO,KAAK,EACX,qBAAqB,EAErB,YAAY,EACZ,gBAAgB,EAChB,gBAAgB,EAEhB,cAAc,EACd,qBAAqB,EACrB,oBAAoB,EACpB,qBAAqB,EACrB,MAAM,gCAAgC,CAAC;AACxC,OAAO,EACN,KAAK,WAAW,EAChB,KAAK,cAAc,EAEnB,KAAK,kBAAkB,EACvB,KAAK,cAAc,EACnB,KAAK,gBAAgB,EACrB,MAAM,0BAA0B,CAAC;AAClC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAE9C,mDAAmD;AACnD,eAAO,MAAM,gBAAgB,YAC5B,UAAU,EACV,YAAY,EACZ,QAAQ,EACR,OAAO,EACP,QAAQ,EACR,MAAM,CACG,CAAC;AAOX,MAAM,WAAW,OAAO;IACvB,KAAK,EAAE;QACN,sEAAsE;QACtE,MAAM,CAAC,MAAM,EAAE,qBAAqB,GAAG,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;QAC5D,4EAA4E;QAC5E,QAAQ,CAAC,MAAM,EAAE,qBAAqB,GAAG,OAAO,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC;KACrE,CAAC;IACF,KAAK,EAAE;QACN,MAAM,CAAC,MAAM,EAAE,qBAAqB,GAAG,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;QAC5D,QAAQ,CAAC,MAAM,EAAE,qBAAqB,GAAG,OAAO,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC;KACrE,CAAC;IACF,IAAI,EAAE;QACL,MAAM,CAAC,MAAM,EAAE,oBAAoB,GAAG,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;QAC3D,QAAQ,CAAC,MAAM,EAAE,oBAAoB,GAAG,OAAO,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC;KACpE,CAAC;IACF,uDAAuD;IACvD,KAAK,EAAE;QACN,MAAM,CAAC,MAAM,EAAE,qBAAqB,GAAG,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;QAC5D,QAAQ,CAAC,MAAM,EAAE,qBAAqB,GAAG,OAAO,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC;KACrE,CAAC;IACF,IAAI,EAAE;QACL,uDAAuD;QACvD,IAAI,CAAC,GAAG,EAAE,GAAG,GAAG,OAAO,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC,CAAC;QAC7C,wDAAwD;QACxD,IAAI,CACH,GAAG,EAAE,GAAG,EACR,OAAO,CAAC,EAAE;YAAE,SAAS,CAAC,EAAE,MAAM,CAAA;SAAE,GAC9B,OAAO,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC;KAC/B,CAAC;IACF;;;OAGG;IACH,OAAO,EAAE;QACR,GAAG,CAAC,KAAK,EAAE,MAAM,GAAG,aAAa,GAAG,IAAI,CAAC;QACzC,KAAK,IAAI,IAAI,CAAC;QACd,GAAG,IAAI,aAAa,GAAG,SAAS,CAAC;KACjC,CAAC;IACF;;;OAGG;IACH,MAAM,CAAC,EAAE;QACR;;;;;WAKG;QACH,SAAS,CACR,KAAK,EAAE,qBAAqB,GAAG;YAAE,qBAAqB,CAAC,EAAE,MAAM,CAAA;SAAE,GAC/D,OAAO,CAAC,MAAM,CAAC;YAAE,aAAa,CAAC,EAAE,MAAM,CAAC;YAAC,OAAO,EAAE,gBAAgB,EAAE,CAAA;SAAE,CAAC,CAAC,CAAC;KAC5E,CAAC;IACF;;;;;OAKG;IACH,KAAK,CAAC,EAAE;QACP,wDAAwD;QACxD,aAAa,CAAC,KAAK,EAAE,kBAAkB,GAAG,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;QAC/D,8EAA8E;QAC9E,SAAS,CAAC,KAAK,EAAE,cAAc,GAAG,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;QACvD,6DAA6D;QAC7D,MAAM,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;QACjD,iDAAiD;QACjD,WAAW,CAAC,KAAK,EAAE,gBAAgB,GAAG,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;QAC3D,mDAAmD;QACnD,SAAS,CAAC,KAAK,EAAE,cAAc,GAAG,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;KACvD,CAAC;IACF,kCAAkC;IAClC,MAAM,IAAI,aAAa,EAAE,CAAC;IAC1B;;;;OAIG;IACH,YAAY,CACX,IAAI,EAAE,cAAc,EACpB,MAAM,EAAE,gBAAgB,GACtB,OAAO,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC,CAAC;CACjC;AAED,wBAAgB,WAAW,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CA6iB5D;AAED,YAAY,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,EAAE,CAAC;AAC5C,OAAO,EAAE,QAAQ,EAAE,CAAC"}

package/dist/helpers/result.d.ts

@@ -2,7 +2,7 @@ import type { GenerationOutput } from "../ports/content-generator.port";
 export type AIErrorCode = 
 /** The model id is not in the catalog. */
 "unknown_model"
-/** The model's provider has no API key configured on this client. */
+/** The model's provider has no vendor key and no Brotu key. */
  | "missing_key"
 /** No adapter ships for that provider. */
  | "unsupported_provider"

package/dist/helpers/result.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"result.d.ts","sourceRoot":"","sources":["../../src/helpers/result.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,iCAAiC,CAAC;AAExE,MAAM,MAAM,WAAW;AACtB,0CAA0C;AACxC,eAAe;AACjB,qEAAqE;GACnE,aAAa;AACf,0CAA0C;GACxC,sBAAsB;AACxB,kEAAkE;GAChE,iBAAiB;AACnB,yEAAyE;GACvE,gBAAgB;AAClB,2EAA2E;GACzE,SAAS,CAAC;AAEb,MAAM,WAAW,OAAO;IACvB,IAAI,EAAE,WAAW,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,wDAAwD;IACxD,KAAK,CAAC,EAAE,OAAO,CAAC;CAChB;AAED;;;;;;;GAOG;AACH,MAAM,MAAM,MAAM,CAAC,CAAC,IACjB;IAAE,IAAI,EAAE,CAAC,CAAC;IAAC,KAAK,EAAE,IAAI,CAAA;CAAE,GACxB;IAAE,IAAI,EAAE,IAAI,CAAC;IAAC,KAAK,EAAE,OAAO,CAAA;CAAE,CAAC;AAElC,wBAAgB,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,CAExC;AAED,wBAAgB,IAAI,CAAC,CAAC,EAAE,KAAK,EAAE,OAAO,GAAG,MAAM,CAAC,CAAC,CAAC,CAEjD;AAED,gFAAgF;AAChF,wBAAgB,QAAQ,CAAC,CAAC,EACzB,IAAI,EAAE,WAAW,EACjB,KAAK,EAAE,OAAO,EACd,OAAO,CAAC,EAAE;IAAE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,GAC7C,MAAM,CAAC,CAAC,CAAC,CAOX;AAED,iFAAiF;AACjF,MAAM,WAAW,UAAU;IAC1B,OAAO,EAAE,gBAAgB,EAAE,CAAC;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,gBAAgB,EAAE,MAAM,CAAC;IACzB,0DAA0D;IAC1D,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAClC"}
+{"version":3,"file":"result.d.ts","sourceRoot":"","sources":["../../src/helpers/result.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,iCAAiC,CAAC;AAExE,MAAM,MAAM,WAAW;AACtB,0CAA0C;AACxC,eAAe;AACjB,+DAA+D;GAC7D,aAAa;AACf,0CAA0C;GACxC,sBAAsB;AACxB,kEAAkE;GAChE,iBAAiB;AACnB,yEAAyE;GACvE,gBAAgB;AAClB,2EAA2E;GACzE,SAAS,CAAC;AAEb,MAAM,WAAW,OAAO;IACvB,IAAI,EAAE,WAAW,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,wDAAwD;IACxD,KAAK,CAAC,EAAE,OAAO,CAAC;CAChB;AAED;;;;;;;GAOG;AACH,MAAM,MAAM,MAAM,CAAC,CAAC,IACjB;IAAE,IAAI,EAAE,CAAC,CAAC;IAAC,KAAK,EAAE,IAAI,CAAA;CAAE,GACxB;IAAE,IAAI,EAAE,IAAI,CAAC;IAAC,KAAK,EAAE,OAAO,CAAA;CAAE,CAAC;AAElC,wBAAgB,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,CAExC;AAED,wBAAgB,IAAI,CAAC,CAAC,EAAE,KAAK,EAAE,OAAO,GAAG,MAAM,CAAC,CAAC,CAAC,CAEjD;AAED,gFAAgF;AAChF,wBAAgB,QAAQ,CAAC,CAAC,EACzB,IAAI,EAAE,WAAW,EACjB,KAAK,EAAE,OAAO,EACd,OAAO,CAAC,EAAE;IAAE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,GAC7C,MAAM,CAAC,CAAC,CAAC,CAOX;AAED,iFAAiF;AACjF,MAAM,WAAW,UAAU;IAC1B,OAAO,EAAE,gBAAgB,EAAE,CAAC;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,gBAAgB,EAAE,MAAM,CAAC;IACzB,0DAA0D;IAC1D,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAClC"}