@brotu/ai 0.1.0 → 0.3.0

package/dist/index.d.ts

@@ -17,13 +17,14 @@ export type * from "./constants/model.types";
 export { type AIError, type AIErrorCode, fail, type Generation, ok, type Result, } from "./helpers/result";
 export { isPendingJob, type Job, type JobSnapshot, type JobStatus, PendingJob, } from "./lib/jobs";
 export { createS3Storage, persistOutputs, type S3StorageConfig, type Storage, } from "./lib/storage";
+export { deliverWebhook, resolveWebhook, type WebhookConfig, type WebhookEvent, type WebhookEventName, } from "./lib/webhook";
 export type * from "./ports/content-generator.port";
 export { BYTEPLUS_CATALOG, BYTEPLUS_MODELS, type BytePlusModelBinding, } from "./providers/byteplus.models";
 export { ELEVENLABS_CATALOG, ELEVENLABS_MODELS, ELEVENLABS_OUTPUT_FORMATS, } from "./providers/elevenlabs.models";
-export { GOOGLE_CATALOG, GOOGLE_IMAGE_MODELS, GOOGLE_VIDEO_MODELS, } from "./providers/google.models";
+export { GOOGLE_AUDIO_MODELS, GOOGLE_CATALOG, GOOGLE_IMAGE_MODELS, GOOGLE_TEXT_MODELS, GOOGLE_TTS_VOICES, GOOGLE_VIDEO_MODELS, } from "./providers/google.models";
 export type { KlingModelBinding } from "./providers/kling.models";
 export { type AvatarInput, type ImageOmniInput, KLING_CAPABILITIES, KLING_CATALOG, KLING_MODELS, type KlingCapability, type KlingRequestOptions, type KlingResultField, type MotionControlInput, type OmniVideoInput, type OutpaintingInput, } from "./providers/kling.models";
-export { OPENAI_CATALOG, OPENAI_IMAGE_MODELS, } from "./providers/openai.models";
+export { OPENAI_CATALOG, OPENAI_IMAGE_MODELS, OPENAI_TEXT_MODELS, } from "./providers/openai.models";
 export { QWEN_AUDIO_MODELS, QWEN_CATALOG, QWEN_IMAGE_MODELS, QWEN_TEXT_MODELS, QWEN_VIDEO_MODELS, type QwenImageBinding, type QwenVideoBinding, } from "./providers/qwen.models";
 export type { BrotuAIOptions, ProviderConfig, ReferenceVideoInfo, ResolvedProvider, } from "./types";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAC;AAC1E,OAAO,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAC9D,YAAY,EACX,wBAAwB,EACxB,eAAe,GACf,MAAM,+BAA+B,CAAC;AACvC,OAAO,EAAE,iBAAiB,EAAE,MAAM,+BAA+B,CAAC;AAClE,YAAY,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AACtE,OAAO,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAC1D,YAAY,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AACpE,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AACxD,YAAY,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AACtE,OAAO,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAC1D,YAAY,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAClE,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AACtD,OAAO,EACN,kBAAkB,EAClB,QAAQ,EACR,SAAS,EACT,YAAY,EACZ,QAAQ,EACR,cAAc,EACd,YAAY,EACZ,eAAe,GACf,MAAM,WAAW,CAAC;AACnB,YAAY,EAAE,OAAO,EAAE,MAAM,UAAU,CAAC;AACxC,OAAO,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AACvC,mBAAmB,yBAAyB,CAAC;AAC7C,OAAO,EACN,KAAK,OAAO,EACZ,KAAK,WAAW,EAChB,IAAI,EACJ,KAAK,UAAU,EACf,EAAE,EACF,KAAK,MAAM,GACX,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EACN,YAAY,EACZ,KAAK,GAAG,EACR,KAAK,WAAW,EAChB,KAAK,SAAS,EACd,UAAU,GACV,MAAM,YAAY,CAAC;AACpB,OAAO,EACN,eAAe,EACf,cAAc,EACd,KAAK,eAAe,EACpB,KAAK,OAAO,GACZ,MAAM,eAAe,CAAC;AACvB,mBAAmB,gCAAgC,CAAC;AACpD,OAAO,EACN,gBAAgB,EAChB,eAAe,EACf,KAAK,oBAAoB,GACzB,MAAM,6BAA6B,CAAC;AACrC,OAAO,EACN,kBAAkB,EAClB,iBAAiB,EACjB,yBAAyB,GACzB,MAAM,+BAA+B,CAAC;AACvC,OAAO,EACN,cAAc,EACd,mBAAmB,EACnB,mBAAmB,GACnB,MAAM,2BAA2B,CAAC;AACnC,YAAY,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAClE,OAAO,EACN,KAAK,WAAW,EAChB,KAAK,cAAc,EACnB,kBAAkB,EAClB,aAAa,EACb,YAAY,EACZ,KAAK,eAAe,EACpB,KAAK,mBAAmB,EACxB,KAAK,gBAAgB,EACrB,KAAK,kBAAkB,EACvB,KAAK,cAAc,EACnB,KAAK,gBAAgB,GACrB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EACN,cAAc,EACd,mBAAmB,GACnB,MAAM,2BAA2B,CAAC;AACnC,OAAO,EACN,iBAAiB,EACjB,YAAY,EACZ,iBAAiB,EACjB,gBAAgB,EAChB,iBAAiB,EACjB,KAAK,gBAAgB,EACrB,KAAK,gBAAgB,GACrB,MAAM,yBAAyB,CAAC;AACjC,YAAY,EACX,cAAc,EACd,cAAc,EACd,kBAAkB,EAClB,gBAAgB,GAChB,MAAM,SAAS,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAC;AAC1E,OAAO,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAC9D,YAAY,EACX,wBAAwB,EACxB,eAAe,GACf,MAAM,+BAA+B,CAAC;AACvC,OAAO,EAAE,iBAAiB,EAAE,MAAM,+BAA+B,CAAC;AAClE,YAAY,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AACtE,OAAO,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAC1D,YAAY,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AACpE,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AACxD,YAAY,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AACtE,OAAO,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAC1D,YAAY,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAClE,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AACtD,OAAO,EACN,kBAAkB,EAClB,QAAQ,EACR,SAAS,EACT,YAAY,EACZ,QAAQ,EACR,cAAc,EACd,YAAY,EACZ,eAAe,GACf,MAAM,WAAW,CAAC;AACnB,YAAY,EAAE,OAAO,EAAE,MAAM,UAAU,CAAC;AACxC,OAAO,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AACvC,mBAAmB,yBAAyB,CAAC;AAC7C,OAAO,EACN,KAAK,OAAO,EACZ,KAAK,WAAW,EAChB,IAAI,EACJ,KAAK,UAAU,EACf,EAAE,EACF,KAAK,MAAM,GACX,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EACN,YAAY,EACZ,KAAK,GAAG,EACR,KAAK,WAAW,EAChB,KAAK,SAAS,EACd,UAAU,GACV,MAAM,YAAY,CAAC;AACpB,OAAO,EACN,eAAe,EACf,cAAc,EACd,KAAK,eAAe,EACpB,KAAK,OAAO,GACZ,MAAM,eAAe,CAAC;AACvB,OAAO,EACN,cAAc,EACd,cAAc,EACd,KAAK,aAAa,EAClB,KAAK,YAAY,EACjB,KAAK,gBAAgB,GACrB,MAAM,eAAe,CAAC;AACvB,mBAAmB,gCAAgC,CAAC;AACpD,OAAO,EACN,gBAAgB,EAChB,eAAe,EACf,KAAK,oBAAoB,GACzB,MAAM,6BAA6B,CAAC;AACrC,OAAO,EACN,kBAAkB,EAClB,iBAAiB,EACjB,yBAAyB,GACzB,MAAM,+BAA+B,CAAC;AACvC,OAAO,EACN,mBAAmB,EACnB,cAAc,EACd,mBAAmB,EACnB,kBAAkB,EAClB,iBAAiB,EACjB,mBAAmB,GACnB,MAAM,2BAA2B,CAAC;AACnC,YAAY,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAClE,OAAO,EACN,KAAK,WAAW,EAChB,KAAK,cAAc,EACnB,kBAAkB,EAClB,aAAa,EACb,YAAY,EACZ,KAAK,eAAe,EACpB,KAAK,mBAAmB,EACxB,KAAK,gBAAgB,EACrB,KAAK,kBAAkB,EACvB,KAAK,cAAc,EACnB,KAAK,gBAAgB,GACrB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EACN,cAAc,EACd,mBAAmB,EACnB,kBAAkB,GAClB,MAAM,2BAA2B,CAAC;AACnC,OAAO,EACN,iBAAiB,EACjB,YAAY,EACZ,iBAAiB,EACjB,gBAAgB,EAChB,iBAAiB,EACjB,KAAK,gBAAgB,EACrB,KAAK,gBAAgB,GACrB,MAAM,yBAAyB,CAAC;AACjC,YAAY,EACX,cAAc,EACd,cAAc,EACd,kBAAkB,EAClB,gBAAgB,GAChB,MAAM,SAAS,CAAC"}

package/dist/index.js

@@ -5,8 +5,11 @@ import {
   ELEVENLABS_CATALOG,
   ELEVENLABS_MODELS,
   ELEVENLABS_OUTPUT_FORMATS,
+  GOOGLE_AUDIO_MODELS,
   GOOGLE_CATALOG,
   GOOGLE_IMAGE_MODELS,
+  GOOGLE_TEXT_MODELS,
+  GOOGLE_TTS_VOICES,
   GOOGLE_VIDEO_MODELS,
   KLING_AUDIO_MODEL,
   KLING_CAPABILITIES,
@@ -15,6 +18,7 @@ import {
   KLING_VOICES,
   OPENAI_CATALOG,
   OPENAI_IMAGE_MODELS,
+  OPENAI_TEXT_MODELS,
   QWEN_AUDIO_MODELS,
   QWEN_CATALOG,
   QWEN_IMAGE_MODELS,
@@ -31,7 +35,7 @@ import {
   resetCatalog,
   resolveProvider,
   videoPathFor
-} from "./chunk-GKLTQ55S.js";
+} from "./chunk-PL534BFN.js";
 
 // src/lib/jobs.ts
 import { AsyncLocalStorage } from "async_hooks";
@@ -582,7 +586,12 @@ var POLL_INTERVAL_MS2 = 1e4;
 var DEFAULT_MAX_POLL_ATTEMPTS2 = 120;
 var GoogleAdapter = class {
   providerName = "google";
-  supportedTypes = ["image", "video"];
+  supportedTypes = [
+    "image",
+    "video",
+    "text",
+    "audio"
+  ];
   opts;
   constructor(opts) {
     this.opts = opts;
@@ -904,17 +913,143 @@ var GoogleAdapter = class {
   generateVideo(params) {
     return this.runVideo(params);
   }
-  generateAudio(_params) {
-    throw new Error("Google has no speech synthesis wired up here.");
+  textBody(modelId, params) {
+    const input = [
+      { type: "text", text: params.prompt }
+    ];
+    for (const image of params.referenceImages ?? []) {
+      const [meta, data] = image.split(",");
+      input.push({
+        type: "image",
+        mime_type: meta?.match(/data:([^;]+)/)?.[1] ?? "image/png",
+        data: data ?? image
+      });
+    }
+    return {
+      model: modelId,
+      input,
+      ...params.systemPrompt ? { instructions: params.systemPrompt } : {},
+      generation_config: {
+        ...params.maxTokens ? { max_output_tokens: params.maxTokens } : {},
+        ...params.temperature !== void 0 ? { temperature: params.temperature } : {},
+        ...params.topP !== void 0 ? { top_p: params.topP } : {}
+      },
+      ...params.providerOptions?.google ?? {}
+    };
   }
-  generateText(_params) {
-    throw new Error("The Google adapter here covers image and video only.");
+  speechBody(modelId, params, voice) {
+    return {
+      model: modelId,
+      input: params.prompt,
+      response_format: { type: "audio" },
+      generation_config: {
+        speech_config: [{ voice }]
+      },
+      ...params.providerOptions?.google ?? {}
+    };
+  }
+  async generateText(params) {
+    const startedAt = Date.now();
+    const modelId = params.model ?? "";
+    const failure = (error) => ({
+      success: false,
+      outputs: [],
+      creditsUsed: 0,
+      provider: this.providerName,
+      model: modelId,
+      processingTimeMs: Date.now() - startedAt,
+      error
+    });
+    if (!(modelId in GOOGLE_TEXT_MODELS)) {
+      return failure(
+        `"${modelId}" is not a Gemini text model. Known: ${Object.keys(GOOGLE_TEXT_MODELS).join(", ")}.`
+      );
+    }
+    try {
+      const payload = await this.request(
+        INTERACTIONS_PATH,
+        {
+          method: "POST",
+          body: this.textBody(modelId, params)
+        }
+      );
+      const text = payload.output_text ?? payload.steps?.flatMap((step) => step.content ?? []).find((part) => part.type === "text" || part.text)?.text;
+      if (!text) return failure("Google returned no text.");
+      return {
+        success: true,
+        outputs: [
+          {
+            url: `data:text/plain;base64,${Buffer.from(text).toString("base64")}`,
+            mimeType: "text/plain",
+            raw: { text }
+          }
+        ],
+        creditsUsed: 0,
+        provider: this.providerName,
+        model: modelId,
+        processingTimeMs: Date.now() - startedAt
+      };
+    } catch (error) {
+      return failure(error instanceof Error ? error.message : String(error));
+    }
+  }
+  async generateAudio(params) {
+    const startedAt = Date.now();
+    const modelId = params.model ?? "";
+    const failure = (error) => ({
+      success: false,
+      outputs: [],
+      creditsUsed: 0,
+      provider: this.providerName,
+      model: modelId,
+      processingTimeMs: Date.now() - startedAt,
+      error
+    });
+    const binding = GOOGLE_AUDIO_MODELS[modelId];
+    if (!binding) {
+      return failure(
+        `"${modelId}" is not a Gemini speech model. Known: ${Object.keys(GOOGLE_AUDIO_MODELS).join(", ")}.`
+      );
+    }
+    const voice = params.voice ?? "Kore";
+    if (!binding.voices.includes(voice)) {
+      return failure(
+        `Gemini TTS offers ${GOOGLE_TTS_VOICES.join(", ")}, not "${voice}".`
+      );
+    }
+    try {
+      const payload = await this.request(
+        INTERACTIONS_PATH,
+        {
+          method: "POST",
+          body: this.speechBody(modelId, params, voice)
+        }
+      );
+      const data = payload.output_audio?.data;
+      if (!data) return failure("Google returned no audio.");
+      return {
+        success: true,
+        outputs: [
+          {
+            url: `data:audio/wav;base64,${data}`,
+            mimeType: "audio/wav",
+            raw: { inline: true, voice }
+          }
+        ],
+        creditsUsed: 0,
+        provider: this.providerName,
+        model: modelId,
+        processingTimeMs: Date.now() - startedAt
+      };
+    } catch (error) {
+      return failure(error instanceof Error ? error.message : String(error));
+    }
   }
   async estimateCost(type, params) {
     return estimateFor(this.providerName, type, params);
   }
   supportsModel(model) {
-    return model in GOOGLE_IMAGE_MODELS || model in GOOGLE_VIDEO_MODELS;
+    return model in GOOGLE_IMAGE_MODELS || model in GOOGLE_VIDEO_MODELS || model in GOOGLE_TEXT_MODELS || model in GOOGLE_AUDIO_MODELS;
   }
   getAvailableModels() {
     return [
@@ -927,6 +1062,16 @@ var GoogleAdapter = class {
         id,
         name: id,
         type: "video"
+      })),
+      ...Object.keys(GOOGLE_TEXT_MODELS).map((id) => ({
+        id,
+        name: id,
+        type: "text"
+      })),
+      ...Object.keys(GOOGLE_AUDIO_MODELS).map((id) => ({
+        id,
+        name: id,
+        type: "audio"
       }))
     ];
   }
@@ -1283,7 +1428,7 @@ var IMAGES_PATH2 = "/v1/images/generations";
 var OpenAIAdapter = class {
   providerName = "openai";
   // No video: the Videos API shuts down on 24 September 2026.
-  supportedTypes = ["image"];
+  supportedTypes = ["image", "text"];
   opts;
   constructor(opts) {
     this.opts = opts;
@@ -1398,8 +1543,79 @@ var OpenAIAdapter = class {
   generateAudio(_params) {
     throw new Error("OpenAI has no speech synthesis wired up here.");
   }
-  generateText(_params) {
-    throw new Error("The OpenAI adapter here covers images only.");
+  textBody(params) {
+    const content = params.referenceImages?.length ? [
+      { type: "input_text", text: params.prompt },
+      ...params.referenceImages.map((url) => ({
+        type: "input_image",
+        image_url: url
+      }))
+    ] : params.prompt;
+    const input = [];
+    if (params.systemPrompt) {
+      input.push({ role: "system", content: params.systemPrompt });
+    }
+    input.push({ role: "user", content });
+    return {
+      model: params.model,
+      input,
+      ...params.maxTokens ? { max_output_tokens: params.maxTokens } : {},
+      ...params.temperature !== void 0 ? { temperature: params.temperature } : {},
+      ...params.topP !== void 0 ? { top_p: params.topP } : {},
+      ...params.providerOptions?.openai ?? {}
+    };
+  }
+  async generateText(params) {
+    const startedAt = Date.now();
+    const modelId = params.model ?? "";
+    const failure = (error) => ({
+      success: false,
+      outputs: [],
+      creditsUsed: 0,
+      provider: this.providerName,
+      model: modelId,
+      processingTimeMs: Date.now() - startedAt,
+      error
+    });
+    if (!(modelId in OPENAI_TEXT_MODELS)) {
+      return failure(
+        `"${modelId}" is not an OpenAI text model. Known: ${Object.keys(OPENAI_TEXT_MODELS).join(", ")}.`
+      );
+    }
+    try {
+      const response = await fetch(`${this.baseUrl}/v1/responses`, {
+        method: "POST",
+        headers: {
+          Authorization: `Bearer ${this.opts.apiKey}`,
+          "Content-Type": "application/json",
+          ...this.opts.organization ? { "OpenAI-Organization": this.opts.organization } : {}
+        },
+        body: JSON.stringify(this.textBody(params))
+      });
+      const payload = await response.json();
+      if (payload.error) throw new Error(payload.error.message);
+      if (!response.ok) {
+        throw new Error(`OpenAI returned ${response.status}.`);
+      }
+      const text = payload.output_text ?? payload.output?.flatMap((item) => item.content ?? []).find((part) => part.type === "output_text" || part.text)?.text;
+      if (!text) return failure("OpenAI returned no text.");
+      return {
+        success: true,
+        outputs: [
+          {
+            url: `data:text/plain;base64,${Buffer.from(text).toString("base64")}`,
+            mimeType: "text/plain",
+            raw: { text, tokens: payload.usage?.output_tokens }
+          }
+        ],
+        creditsUsed: 0,
+        provider: this.providerName,
+        model: modelId,
+        processingTimeMs: Date.now() - startedAt
+      };
+    } catch (error) {
+      return failure(error instanceof Error ? error.message : String(error));
+    }
   }
   /** Synchronous provider: there is never a queued job to come back to. */
   async completeJob(job) {
@@ -1420,14 +1636,21 @@ var OpenAIAdapter = class {
     };
   }
   supportsModel(model) {
-    return model in OPENAI_IMAGE_MODELS;
+    return model in OPENAI_IMAGE_MODELS || model in OPENAI_TEXT_MODELS;
   }
   getAvailableModels() {
-    return Object.keys(OPENAI_IMAGE_MODELS).map((id) => ({
-      id,
-      name: id,
-      type: "image"
-    }));
+    return [
+      ...Object.keys(OPENAI_IMAGE_MODELS).map((id) => ({
+        id,
+        name: id,
+        type: "image"
+      })),
+      ...Object.keys(OPENAI_TEXT_MODELS).map((id) => ({
+        id,
+        name: id,
+        type: "text"
+      }))
+    ];
   }
 };
 
@@ -2033,6 +2256,45 @@ async function persistOutputs(storage, outputs) {
   );
 }
 
+// src/lib/webhook.ts
+function resolveWebhook(value) {
+  if (!value) return void 0;
+  if (typeof value === "string") {
+    return isHttpUrl(value) ? { url: value } : void 0;
+  }
+  if (!isHttpUrl(value.url)) return void 0;
+  return {
+    url: value.url,
+    secret: value.secret,
+    headers: value.headers
+  };
+}
+function isHttpUrl(value) {
+  try {
+    const parsed = new URL(value);
+    return parsed.protocol === "https:" || parsed.protocol === "http:";
+  } catch {
+    return false;
+  }
+}
+async function deliverWebhook(config, payload) {
+  try {
+    await fetch(config.url, {
+      method: "POST",
+      headers: {
+        "content-type": "application/json",
+        "user-agent": "@brotu/ai",
+        "x-brotu-event": payload.event,
+        ...config.secret ? { "x-brotu-webhook-secret": config.secret } : {},
+        ...config.headers
+      },
+      body: JSON.stringify(payload),
+      signal: AbortSignal.timeout(1e4)
+    });
+  } catch {
+  }
+}
+
 // src/client.ts
 var NATIVE_PROVIDERS = [
   "byteplus",
@@ -2047,6 +2309,8 @@ function brotuClient(options) {
     throw new Error("brotuClient requires at least one provider API key.");
   }
   registerModels(options.models);
+  let registeredWebhook = resolveWebhook(options.webhook);
+  const notifiedJobIds = /* @__PURE__ */ new Set();
   const storage = options.storage ? createS3Storage(options.storage) : void 0;
   const shouldPersist = storage && options.storage?.persistOutputs !== false;
   const adapters = /* @__PURE__ */ new Map();
@@ -2136,6 +2400,31 @@ function brotuClient(options) {
       return adapter.generateAudio(params);
     return adapter.generateText(params);
   }
+  function webhookFor(params) {
+    return resolveWebhook(params?.webhook) ?? registeredWebhook;
+  }
+  async function notifySettled(input) {
+    const config = webhookFor(input.params);
+    if (!config) return;
+    const jobId = input.job?.id;
+    if (jobId) {
+      if (notifiedJobIds.has(jobId)) return;
+      notifiedJobIds.add(jobId);
+    }
+    const payload = {
+      event: input.event,
+      jobId,
+      provider: input.provider ?? input.job?.provider,
+      model: input.model ?? input.job?.model,
+      kind: input.kind ?? input.job?.kind,
+      outputs: input.outputs,
+      error: input.error ? { code: input.error.code, message: input.error.message } : void 0,
+      metadata: input.metadata ?? input.job?.metadata,
+      processingTimeMs: input.processingTimeMs,
+      completedAt: (/* @__PURE__ */ new Date()).toISOString()
+    };
+    await deliverWebhook(config, payload);
+  }
   async function toGeneration(raw, metadata) {
     if (!raw.success) {
       return fail({
@@ -2158,15 +2447,50 @@ function brotuClient(options) {
     const routed = route(params.model);
     if (routed.error) return fail(routed.error);
     try {
-      return await toGeneration(
+      const result = await toGeneration(
         await generateWith(routed.data.adapter, kind, params),
         params.metadata
       );
+      if (result.error) {
+        await notifySettled({
+          event: "generation.failed",
+          params,
+          kind,
+          provider: routed.data.provider,
+          model: routed.data.model,
+          error: result.error,
+          metadata: params.metadata
+        });
+        return result;
+      }
+      await notifySettled({
+        event: "generation.succeeded",
+        params,
+        kind,
+        provider: result.data.provider,
+        model: result.data.model,
+        outputs: result.data.outputs,
+        metadata: result.data.metadata,
+        processingTimeMs: result.data.processingTimeMs
+      });
+      return result;
     } catch (error) {
-      return failFrom("provider_error", error, {
+      const failed = failFrom("provider_error", error, {
         provider: routed.data.provider,
         model: routed.data.model
       });
+      if (failed.error) {
+        await notifySettled({
+          event: "generation.failed",
+          params,
+          kind,
+          provider: routed.data.provider,
+          model: routed.data.model,
+          error: failed.error,
+          metadata: params.metadata
+        });
+      }
+      return failed;
     }
   }
   async function submit(kind, params) {
@@ -2185,18 +2509,40 @@ function brotuClient(options) {
         () => generateWith(routed.data.adapter, kind, params)
       );
       if (!raw.success) {
-        return fail({
+        const error = {
           code: "provider_error",
           message: raw.error ?? "The provider rejected the request.",
           provider: raw.provider,
           model: raw.model
+        };
+        await notifySettled({
+          event: "generation.failed",
+          params,
+          kind,
+          provider: raw.provider,
+          model: raw.model,
+          error,
+          metadata: params.metadata
         });
+        return fail(error);
       }
-      return ok({
+      const job = {
         ...base,
         id: `inline-${base.model}-${base.submittedAt}`,
         result: raw
+      };
+      await notifySettled({
+        event: "generation.succeeded",
+        params,
+        job,
+        kind,
+        provider: raw.provider,
+        model: raw.model,
+        outputs: raw.outputs,
+        metadata: params.metadata,
+        processingTimeMs: raw.processingTimeMs
       });
+      return ok(job);
     } catch (error) {
       if (!isPendingJob(error)) {
         return failFrom("provider_error", error, {
@@ -2211,11 +2557,54 @@ function brotuClient(options) {
       });
     }
   }
+  async function notifyFromSnapshot(job, snapshot) {
+    if (snapshot.status === "succeeded" && snapshot.result) {
+      await notifySettled({
+        event: "generation.succeeded",
+        params: job.params,
+        job,
+        outputs: snapshot.result.outputs,
+        provider: snapshot.result.provider,
+        model: snapshot.result.model,
+        processingTimeMs: snapshot.result.processingTimeMs,
+        metadata: job.metadata
+      });
+      return;
+    }
+    if (snapshot.status === "failed") {
+      await notifySettled({
+        event: "generation.failed",
+        params: job.params,
+        job,
+        error: {
+          code: "provider_error",
+          message: snapshot.error ?? "The job failed.",
+          provider: job.provider,
+          model: job.model
+        },
+        metadata: job.metadata
+      });
+    }
+  }
+  async function finalizeSnapshot(job, snapshot) {
+    if (snapshot.status === "succeeded" && snapshot.result) {
+      const persisted = await toGeneration(snapshot.result, job.metadata);
+      if (!persisted.error) {
+        snapshot = {
+          status: "succeeded",
+          result: {
+            ...snapshot.result,
+            outputs: persisted.data.outputs
+          }
+        };
+      }
+    }
+    await notifyFromSnapshot(job, snapshot);
+    return snapshot;
+  }
   async function pollJob(job) {
     if (job.result) {
-      return ok(
-        job.result.success ? { status: "succeeded", result: job.result } : { status: "failed", error: job.result.error }
-      );
+      return ok(await finalizeSnapshot(job, job.result.success ? { status: "succeeded", result: job.result } : { status: "failed", error: job.result.error }));
     }
     const routed = route(job.model);
     if (routed.error) return fail(routed.error);
@@ -2228,7 +2617,7 @@ function brotuClient(options) {
       });
     }
     try {
-      return ok(await adapter.completeJob(job));
+      return ok(await finalizeSnapshot(job, await adapter.completeJob(job)));
     } catch (error) {
       return failFrom("provider_error", error, {
         provider: job.provider,
@@ -2297,6 +2686,17 @@ function brotuClient(options) {
       submit: (params) => submit("audio", params),
       generate: (params) => generate("audio", params)
     },
+    webhook: {
+      set(value) {
+        registeredWebhook = resolveWebhook(value);
+      },
+      clear() {
+        registeredWebhook = void 0;
+      },
+      get() {
+        return registeredWebhook;
+      }
+    },
     jobs: {
       poll: pollJob,
       wait: async (job, waitOptions) => {
@@ -2306,7 +2706,13 @@ function brotuClient(options) {
           if (polled.error) return fail(polled.error);
           const snapshot = polled.data;
           if (snapshot.status === "succeeded" && snapshot.result) {
-            return toGeneration(snapshot.result, job.metadata);
+            return ok({
+              outputs: snapshot.result.outputs,
+              provider: snapshot.result.provider,
+              model: snapshot.result.model,
+              processingTimeMs: snapshot.result.processingTimeMs,
+              metadata: job.metadata
+            });
           }
           if (snapshot.status === "failed") {
             return fail({
@@ -2351,8 +2757,11 @@ export {
   ELEVENLABS_MODELS,
   ELEVENLABS_OUTPUT_FORMATS,
   ElevenLabsAdapter,
+  GOOGLE_AUDIO_MODELS,
   GOOGLE_CATALOG,
   GOOGLE_IMAGE_MODELS,
+  GOOGLE_TEXT_MODELS,
+  GOOGLE_TTS_VOICES,
   GOOGLE_VIDEO_MODELS,
   GoogleAdapter,
   KLING_CAPABILITIES,
@@ -2361,6 +2770,7 @@ export {
   KlingAdapter,
   OPENAI_CATALOG,
   OPENAI_IMAGE_MODELS,
+  OPENAI_TEXT_MODELS,
   OpenAIAdapter,
   PendingJob,
   QWEN_AUDIO_MODELS,
@@ -2371,6 +2781,7 @@ export {
   QwenAdapter,
   brotuClient,
   createS3Storage,
+  deliverWebhook,
   fail,
   getAvailableModels,
   getModel,
@@ -2382,5 +2793,6 @@ export {
   persistOutputs,
   registerModels,
   resetCatalog,
-  resolveProvider
+  resolveProvider,
+  resolveWebhook
 };

package/dist/lib/webhook.d.ts

@@ -0,0 +1,28 @@
+import type { AIError } from "../helpers/result";
+import type { GenerationOutput, GenerationType } from "../ports/content-generator.port";
+export type WebhookEventName = "generation.succeeded" | "generation.failed";
+export interface WebhookConfig {
+    url: string;
+    /** Sent as `x-brotu-webhook-secret` so your endpoint can reject strangers. */
+    secret?: string;
+    headers?: Record<string, string>;
+}
+export interface WebhookEvent {
+    event: WebhookEventName;
+    jobId?: string;
+    provider?: string;
+    model?: string;
+    kind?: GenerationType;
+    outputs?: GenerationOutput[];
+    error?: Pick<AIError, "code" | "message">;
+    metadata?: Record<string, string>;
+    processingTimeMs?: number;
+    completedAt: string;
+}
+export declare function resolveWebhook(value: string | WebhookConfig | undefined): WebhookConfig | undefined;
+/**
+ * POST the settled generation at the registered URL. Failures are swallowed:
+ * a down hook must not fail the call the user is waiting on.
+ */
+export declare function deliverWebhook(config: WebhookConfig, payload: WebhookEvent): Promise<void>;
+//# sourceMappingURL=webhook.d.ts.map

package/dist/lib/webhook.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"webhook.d.ts","sourceRoot":"","sources":["../../src/lib/webhook.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,KAAK,EACX,gBAAgB,EAChB,cAAc,EACd,MAAM,iCAAiC,CAAC;AAEzC,MAAM,MAAM,gBAAgB,GAAG,sBAAsB,GAAG,mBAAmB,CAAC;AAE5E,MAAM,WAAW,aAAa;IAC7B,GAAG,EAAE,MAAM,CAAC;IACZ,8EAA8E;IAC9E,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACjC;AAED,MAAM,WAAW,YAAY;IAC5B,KAAK,EAAE,gBAAgB,CAAC;IACxB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,cAAc,CAAC;IACtB,OAAO,CAAC,EAAE,gBAAgB,EAAE,CAAC;IAC7B,KAAK,CAAC,EAAE,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC;IAC1C,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAClC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,WAAW,EAAE,MAAM,CAAC;CACpB;AAED,wBAAgB,cAAc,CAC7B,KAAK,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS,GACvC,aAAa,GAAG,SAAS,CAW3B;AAWD;;;GAGG;AACH,wBAAsB,cAAc,CACnC,MAAM,EAAE,aAAa,EACrB,OAAO,EAAE,YAAY,GACnB,OAAO,CAAC,IAAI,CAAC,CAmBf"}