@brotu/ai 0.1.0 → 0.3.0

package/dist/index.cjs

@@ -37,8 +37,11 @@ __export(index_exports, {
   ELEVENLABS_MODELS: () => ELEVENLABS_MODELS,
   ELEVENLABS_OUTPUT_FORMATS: () => ELEVENLABS_OUTPUT_FORMATS,
   ElevenLabsAdapter: () => ElevenLabsAdapter,
+  GOOGLE_AUDIO_MODELS: () => GOOGLE_AUDIO_MODELS,
   GOOGLE_CATALOG: () => GOOGLE_CATALOG,
   GOOGLE_IMAGE_MODELS: () => GOOGLE_IMAGE_MODELS,
+  GOOGLE_TEXT_MODELS: () => GOOGLE_TEXT_MODELS,
+  GOOGLE_TTS_VOICES: () => GOOGLE_TTS_VOICES,
   GOOGLE_VIDEO_MODELS: () => GOOGLE_VIDEO_MODELS,
   GoogleAdapter: () => GoogleAdapter,
   KLING_CAPABILITIES: () => KLING_CAPABILITIES,
@@ -47,6 +50,7 @@ __export(index_exports, {
   KlingAdapter: () => KlingAdapter,
   OPENAI_CATALOG: () => OPENAI_CATALOG,
   OPENAI_IMAGE_MODELS: () => OPENAI_IMAGE_MODELS,
+  OPENAI_TEXT_MODELS: () => OPENAI_TEXT_MODELS,
   OpenAIAdapter: () => OpenAIAdapter,
   PendingJob: () => PendingJob,
   QWEN_AUDIO_MODELS: () => QWEN_AUDIO_MODELS,
@@ -57,6 +61,7 @@ __export(index_exports, {
   QwenAdapter: () => QwenAdapter,
   brotuClient: () => brotuClient,
   createS3Storage: () => createS3Storage,
+  deliverWebhook: () => deliverWebhook,
   fail: () => fail,
   getAvailableModels: () => getAvailableModels,
   getModel: () => getModel,
@@ -68,7 +73,8 @@ __export(index_exports, {
   persistOutputs: () => persistOutputs,
   registerModels: () => registerModels,
   resetCatalog: () => resetCatalog,
-  resolveProvider: () => resolveProvider
+  resolveProvider: () => resolveProvider,
+  resolveWebhook: () => resolveWebhook
 });
 module.exports = __toCommonJS(index_exports);
 
@@ -398,6 +404,55 @@ var GOOGLE_VIDEO_MODELS = {
     conversationalEditing: true
   }
 };
+var GOOGLE_TEXT_MODELS = {
+  "gemini-3.7-flash": { usdPerMillionOutput: 3.75 },
+  "gemini-3.6-flash": { usdPerMillionOutput: 3.75 },
+  "gemini-3.5-flash": { usdPerMillionOutput: 9 },
+  "gemini-3.5-flash-lite": {},
+  "gemini-3.1-flash-lite": {},
+  "gemini-3.1-pro-preview": { usdPerMillionOutput: 12 },
+  "gemini-3-flash-preview": {},
+  "gemini-2.5-pro": {},
+  "gemini-2.5-flash": {},
+  "gemini-2.5-flash-lite": {}
+};
+var GOOGLE_TTS_VOICES = [
+  "Zephyr",
+  "Puck",
+  "Charon",
+  "Kore",
+  "Fenrir",
+  "Leda",
+  "Orus",
+  "Aoede",
+  "Callirrhoe",
+  "Autonoe",
+  "Enceladus",
+  "Iapetus",
+  "Umbriel",
+  "Algieba",
+  "Despina",
+  "Erinome",
+  "Algenib",
+  "Rasalgethi",
+  "Laomedeia",
+  "Achernar",
+  "Alnilam",
+  "Schedar",
+  "Gacrux",
+  "Pulcherrima",
+  "Achird",
+  "Zubenelgenubi",
+  "Vindemiatrix",
+  "Sadachbia",
+  "Sadaltager",
+  "Sulafat"
+];
+var GOOGLE_AUDIO_MODELS = {
+  "gemini-3.1-flash-tts-preview": { voices: GOOGLE_TTS_VOICES },
+  "gemini-2.5-flash-preview-tts": { voices: GOOGLE_TTS_VOICES },
+  "gemini-2.5-pro-preview-tts": { voices: GOOGLE_TTS_VOICES }
+};
 var GOOGLE_CATALOG = [
   ...Object.entries(GOOGLE_IMAGE_MODELS).map(
     ([id, binding]) => ({
@@ -434,6 +489,35 @@ var GOOGLE_CATALOG = [
         byResolution: binding.usdByResolution
       }
     })
+  ),
+  ...Object.entries(GOOGLE_TEXT_MODELS).map(
+    ([id, binding]) => ({
+      id,
+      name: id,
+      category: "text",
+      inputType: "image_optional",
+      nodeTypes: ["text"],
+      creditsPerUnit: 0,
+      creditUnit: "token",
+      provider: "google",
+      pricing: binding.usdPerMillionOutput === void 0 ? void 0 : {
+        unit: "token",
+        usdPerUnit: binding.usdPerMillionOutput / 1e6
+      }
+    })
+  ),
+  ...Object.entries(GOOGLE_AUDIO_MODELS).map(
+    ([id, binding]) => ({
+      id,
+      name: id,
+      category: "audio",
+      inputType: "text_only",
+      nodeTypes: ["text"],
+      creditsPerUnit: 0,
+      creditUnit: "character",
+      provider: "google",
+      description: `Voices: ${binding.voices.join(", ")}`
+    })
   )
 ];
 
@@ -824,23 +908,42 @@ var OPENAI_IMAGE_MODELS = {
     usd: { low: 0.011, medium: 0.042, high: 0.167 }
   }
 };
-var OPENAI_CATALOG = Object.entries(
-  OPENAI_IMAGE_MODELS
-).map(([id, binding]) => ({
-  id,
-  name: id,
-  category: "image",
-  inputType: "image_optional",
-  nodeTypes: ["image_gen"],
-  creditsPerUnit: 0,
-  creditUnit: "image",
-  supportedResolutions: binding.sizes === "any" ? void 0 : binding.sizes,
-  provider: "openai",
-  // Medium is the sane middle; `quality: auto` can silently pick high, which
-  // is 35x the low tier.
-  pricing: { usdPerUnit: binding.usd.medium, unit: "image" },
-  description: binding.shutdownOn ? `Deprecated \u2014 OpenAI shuts this down on ${binding.shutdownOn}.` : void 0
-}));
+var OPENAI_TEXT_MODELS = {
+  "gpt-5.6-sol": { usdPerMillionOutput: 30 },
+  "gpt-5.6-terra": { usdPerMillionOutput: 12 },
+  "gpt-5.6-luna": { usdPerMillionOutput: 1.2 }
+};
+var OPENAI_CATALOG = [
+  ...Object.entries(OPENAI_IMAGE_MODELS).map(([id, binding]) => ({
+    id,
+    name: id,
+    category: "image",
+    inputType: "image_optional",
+    nodeTypes: ["image_gen"],
+    creditsPerUnit: 0,
+    creditUnit: "image",
+    supportedResolutions: binding.sizes === "any" ? void 0 : binding.sizes,
+    provider: "openai",
+    // Medium is the sane middle; `quality: auto` can silently pick high, which
+    // is 35x the low tier.
+    pricing: { usdPerUnit: binding.usd.medium, unit: "image" },
+    description: binding.shutdownOn ? `Deprecated \u2014 OpenAI shuts this down on ${binding.shutdownOn}.` : void 0
+  })),
+  ...Object.entries(OPENAI_TEXT_MODELS).map(([id, binding]) => ({
+    id,
+    name: id,
+    category: "text",
+    inputType: "image_optional",
+    nodeTypes: ["text"],
+    creditsPerUnit: 0,
+    creditUnit: "token",
+    provider: "openai",
+    pricing: {
+      unit: "token",
+      usdPerUnit: binding.usdPerMillionOutput / 1e6
+    }
+  }))
+];
 
 // src/providers/qwen.models.ts
 var VIDEO_PATH = "/api/v1/services/aigc/video-generation/video-synthesis";
@@ -1763,7 +1866,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;
@@ -2085,17 +2193,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 [
@@ -2108,6 +2342,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"
       }))
     ];
   }
@@ -2464,7 +2708,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;
@@ -2579,8 +2823,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) {
@@ -2601,14 +2916,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"
+      }))
+    ];
   }
 };
 
@@ -3214,6 +3536,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",
@@ -3228,6 +3589,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();
@@ -3317,6 +3680,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({
@@ -3339,15 +3727,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) {
@@ -3366,18 +3789,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, {
@@ -3392,11 +3837,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);
@@ -3409,7 +3897,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,
@@ -3478,6 +3966,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) => {
@@ -3487,7 +3986,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({
@@ -3533,8 +4038,11 @@ function brotuClient(options) {
   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,
@@ -3543,6 +4051,7 @@ function brotuClient(options) {
   KlingAdapter,
   OPENAI_CATALOG,
   OPENAI_IMAGE_MODELS,
+  OPENAI_TEXT_MODELS,
   OpenAIAdapter,
   PendingJob,
   QWEN_AUDIO_MODELS,
@@ -3553,6 +4062,7 @@ function brotuClient(options) {
   QwenAdapter,
   brotuClient,
   createS3Storage,
+  deliverWebhook,
   fail,
   getAvailableModels,
   getModel,
@@ -3564,5 +4074,6 @@ function brotuClient(options) {
   persistOutputs,
   registerModels,
   resetCatalog,
-  resolveProvider
+  resolveProvider,
+  resolveWebhook
 });