@brotu/ai 0.2.0 → 0.4.0

package/dist/index.cjs

@@ -32,7 +32,9 @@ var index_exports = {};
 __export(index_exports, {
   BYTEPLUS_CATALOG: () => BYTEPLUS_CATALOG,
   BYTEPLUS_MODELS: () => BYTEPLUS_MODELS,
+  BrotuAdapter: () => BrotuAdapter,
   BytePlusAdapter: () => BytePlusAdapter,
+  DEFAULT_BROTU_API_URL: () => DEFAULT_BROTU_API_URL,
   ELEVENLABS_CATALOG: () => ELEVENLABS_CATALOG,
   ELEVENLABS_MODELS: () => ELEVENLABS_MODELS,
   ELEVENLABS_OUTPUT_FORMATS: () => ELEVENLABS_OUTPUT_FORMATS,
@@ -61,6 +63,7 @@ __export(index_exports, {
   QwenAdapter: () => QwenAdapter,
   brotuClient: () => brotuClient,
   createS3Storage: () => createS3Storage,
+  deliverWebhook: () => deliverWebhook,
   fail: () => fail,
   getAvailableModels: () => getAvailableModels,
   getModel: () => getModel,
@@ -72,7 +75,8 @@ __export(index_exports, {
   persistOutputs: () => persistOutputs,
   registerModels: () => registerModels,
   resetCatalog: () => resetCatalog,
-  resolveProvider: () => resolveProvider
+  resolveProvider: () => resolveProvider,
+  resolveWebhook: () => resolveWebhook
 });
 module.exports = __toCommonJS(index_exports);
 
@@ -1265,8 +1269,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,
@@ -1322,24 +1334,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
   );
 }
 
@@ -1369,12 +1393,316 @@ function estimateFor(provider, type, params, defaults) {
   };
 }
 
+// src/adapters/brotu.adapter.ts
+var DEFAULT_API_URL = "https://api.brotu.app";
+var POLL_INTERVAL_MS = 3e3;
+var DEFAULT_MAX_POLL_ATTEMPTS = 400;
+var PLATFORM_MODEL_IDS = {
+  "kling/v2-6": "kling-2.6",
+  "kling/v3": "kling-3.0/video",
+  "dreamina-seedance-2-5-260628": "bytedance/seedance-2-5",
+  "dreamina-seedance-2-0-260128": "bytedance/seedance-2",
+  "dreamina-seedance-2-0-fast-260128": "bytedance/seedance-2-fast",
+  "gpt-image-1.5": "gpt-image/1.5"
+};
+var UNSUPPORTED_VIA_CREDITS = "Speech and text generate on the vendor. Pass that provider's key.";
+var BrotuAdapter = class {
+  constructor(opts) {
+    this.opts = opts;
+  }
+  opts;
+  providerName = "brotu";
+  supportedTypes = ["image", "video"];
+  workspaceIdCache;
+  get origin() {
+    return (this.opts.apiUrl ?? DEFAULT_API_URL).replace(/\/$/, "");
+  }
+  headers() {
+    return {
+      Authorization: `Bearer ${this.opts.apiKey}`,
+      "Content-Type": "application/json"
+    };
+  }
+  async workspaceId() {
+    if (this.opts.workspaceId) return this.opts.workspaceId;
+    if (this.workspaceIdCache) return this.workspaceIdCache;
+    const payload = await this.request("/api/v1/studio/default-workspace");
+    const id = payload.workspaceId?.trim();
+    if (!id) {
+      throw new Error(
+        "This Brotu account has no workspace. Open https://brotu.app and create one."
+      );
+    }
+    this.workspaceIdCache = id;
+    return id;
+  }
+  studioPath(path, workspaceId) {
+    const joiner = path.includes("?") ? "&" : "?";
+    return `${path}${joiner}workspaceId=${encodeURIComponent(workspaceId)}`;
+  }
+  async request(path, init) {
+    const response = await fetch(`${this.origin}${path}`, {
+      ...init,
+      headers: { ...this.headers(), ...init?.headers }
+    });
+    const text = await response.text();
+    let body = void 0;
+    if (text) {
+      try {
+        body = JSON.parse(text);
+      } catch {
+        body = text;
+      }
+    }
+    if (!response.ok) {
+      const parsed = body;
+      const message = parsed && typeof parsed === "object" ? parsed.error?.message || parsed.message || text : text;
+      throw new Error(message || `Brotu API ${response.status}`);
+    }
+    return body;
+  }
+  platformModel(modelId) {
+    return PLATFORM_MODEL_IDS[modelId] ?? modelId;
+  }
+  async startGeneration(kind, params) {
+    const modelId = params.model ?? "";
+    const workspaceId = await this.workspaceId();
+    const path = kind === "video" ? "/api/v1/studio/videos" : "/api/v1/studio/images";
+    const body = kind === "video" ? this.videoBody(params, modelId) : this.imageBody(params, modelId);
+    const result = await this.request(
+      this.studioPath(path, workspaceId),
+      { method: "POST", body: JSON.stringify(body) }
+    );
+    const generationId = result.generationId?.trim();
+    if (!generationId) {
+      throw new Error("Brotu accepted the request but returned no generation id.");
+    }
+    return { generationId, workspaceId };
+  }
+  imageBody(params, modelId) {
+    return {
+      prompt: params.prompt,
+      model: this.platformModel(modelId),
+      aspectRatio: params.aspectRatio,
+      resolution: params.resolution,
+      negativePrompt: params.negativePrompt,
+      outputFormat: params.outputFormat,
+      seed: params.seed,
+      referenceImages: params.referenceImages
+    };
+  }
+  videoBody(params, modelId) {
+    return {
+      prompt: params.prompt,
+      model: this.platformModel(modelId),
+      duration: params.duration,
+      resolution: params.resolution,
+      aspectRatio: params.aspectRatio,
+      mode: params.mode,
+      withAudio: params.withAudio,
+      seed: params.seed,
+      imageUrl: params.imageUrl,
+      imageUrls: params.imageUrls,
+      videoUrl: params.videoUrl,
+      videoUrls: params.videoUrls,
+      referenceImages: params.referenceImages
+    };
+  }
+  async run(kind, params) {
+    const startedAt = Date.now();
+    const modelId = params.model ?? "(none)";
+    const failure = (error) => ({
+      success: false,
+      outputs: [],
+      creditsUsed: 0,
+      provider: this.providerName,
+      model: modelId,
+      processingTimeMs: Date.now() - startedAt,
+      error
+    });
+    let submitted;
+    try {
+      submitted = await this.startGeneration(kind, params);
+    } catch (error) {
+      return failure(error instanceof Error ? error.message : String(error));
+    }
+    const pollEndpoint = this.studioPath(
+      `/api/v1/studio/generations/${submitted.generationId}`,
+      submitted.workspaceId
+    );
+    if (isSubmitMode()) {
+      throw new PendingJob(submitted.generationId, pollEndpoint);
+    }
+    const job = {
+      id: submitted.generationId,
+      provider: this.providerName,
+      model: modelId,
+      kind,
+      pollEndpoint,
+      params,
+      submittedAt: new Date(startedAt).toISOString()
+    };
+    const maxAttempts = this.opts.maxPollAttempts ?? DEFAULT_MAX_POLL_ATTEMPTS;
+    for (let attempt = 0; attempt < maxAttempts; attempt++) {
+      const snapshot = await this.completeJob(job);
+      if (snapshot.status === "failed") {
+        return failure(snapshot.error ?? "Brotu generation failed.");
+      }
+      if (snapshot.status === "succeeded" && snapshot.result) {
+        return { ...snapshot.result, processingTimeMs: Date.now() - startedAt };
+      }
+      await new Promise((resolve) => setTimeout(resolve, POLL_INTERVAL_MS));
+    }
+    return failure(
+      `Brotu generation ${submitted.generationId} did not finish after ${maxAttempts} checks.`
+    );
+  }
+  async completeJob(job) {
+    const workspaceId = this.workspaceFromPoll(job.pollEndpoint) ?? await this.workspaceId();
+    const path = this.studioPath(
+      `/api/v1/studio/generations/${job.id}`,
+      workspaceId
+    );
+    const generation = await this.request(path);
+    const status = (generation.status ?? "").toLowerCase();
+    if (status === "failed") {
+      return {
+        status: "failed",
+        error: generation.errorMessage ?? "Brotu generation failed."
+      };
+    }
+    if (status !== "completed") {
+      return { status: "pending" };
+    }
+    const outputs = outputsFrom(generation, job.kind);
+    return {
+      status: "succeeded",
+      result: {
+        success: true,
+        outputs,
+        creditsUsed: generation.creditsUsed ?? 0,
+        provider: this.providerName,
+        model: job.model,
+        processingTimeMs: 0
+      }
+    };
+  }
+  workspaceFromPoll(pollEndpoint) {
+    if (!pollEndpoint) return void 0;
+    try {
+      const url = new URL(pollEndpoint, "https://brotu.invalid");
+      return url.searchParams.get("workspaceId") ?? void 0;
+    } catch {
+      return void 0;
+    }
+  }
+  generateImage(params) {
+    return this.run("image", params);
+  }
+  generateVideo(params) {
+    return this.run("video", params);
+  }
+  async generateText(params) {
+    return {
+      success: false,
+      outputs: [],
+      creditsUsed: 0,
+      provider: this.providerName,
+      model: params.model ?? "(none)",
+      processingTimeMs: 0,
+      error: UNSUPPORTED_VIA_CREDITS
+    };
+  }
+  async generateAudio(params) {
+    return {
+      success: false,
+      outputs: [],
+      creditsUsed: 0,
+      provider: this.providerName,
+      model: params.model ?? "(none)",
+      processingTimeMs: 0,
+      error: UNSUPPORTED_VIA_CREDITS
+    };
+  }
+  async estimateCost(type, params) {
+    if (type === "audio" || type === "text") {
+      const estimate = estimateFor(this.providerName, type, params);
+      return {
+        ...estimate,
+        usd: null,
+        note: UNSUPPORTED_VIA_CREDITS
+      };
+    }
+    try {
+      const workspaceId = await this.workspaceId();
+      const video = params;
+      const image = params;
+      const payload = await this.request(
+        this.studioPath("/api/v1/studio/estimate", workspaceId),
+        {
+          method: "POST",
+          body: JSON.stringify({
+            model: this.platformModel(params.model ?? ""),
+            duration: video.duration,
+            resolution: video.resolution ?? image.resolution,
+            aspectRatio: video.aspectRatio ?? image.aspectRatio,
+            withAudio: video.withAudio,
+            hasReferenceImage: Boolean(
+              video.imageUrl || video.imageUrls?.length || video.referenceImages?.length || image.referenceImages?.length
+            ),
+            hasReferenceVideo: Boolean(video.videoUrl || video.videoUrls?.length),
+            quality: image.quality
+          })
+        }
+      );
+      const credits = payload.estimatedCredits ?? 0;
+      return {
+        unit: type === "video" ? "second" : "image",
+        units: credits,
+        usd: null,
+        note: `${credits} Brotu credit${credits === 1 ? "" : "s"}. A vendor key generates on that provider.`,
+        provider: this.providerName,
+        model: params.model ?? ""
+      };
+    } catch (error) {
+      const estimate = estimateFor(this.providerName, type, params);
+      return {
+        ...estimate,
+        usd: null,
+        note: error instanceof Error ? error.message : "Could not estimate Brotu credits."
+      };
+    }
+  }
+  supportsModel() {
+    return true;
+  }
+  getAvailableModels() {
+    return [];
+  }
+};
+function outputsFrom(generation, kind) {
+  const bucket = generation.outputs;
+  const urls = kind === "video" ? bucket?.videos ?? bucket?.images ?? [] : bucket?.images ?? bucket?.videos ?? [];
+  const copies = bucket?.copies ?? [];
+  const mimeType = kind === "video" ? "video/mp4" : "image/png";
+  const fromUrls = urls.filter(Boolean).map((url) => ({
+    url,
+    mimeType
+  }));
+  if (fromUrls.length > 0) return fromUrls;
+  return copies.filter(Boolean).map((url) => ({
+    url,
+    mimeType: "text/plain",
+    raw: { text: url }
+  }));
+}
+
 // src/adapters/byteplus.adapter.ts
 var DEFAULT_BASE_URL = "https://ark.ap-southeast.bytepluses.com";
 var TASKS_PATH = "/api/v3/contents/generations/tasks";
 var IMAGES_PATH = "/api/v3/images/generations";
-var POLL_INTERVAL_MS = 5e3;
-var DEFAULT_MAX_POLL_ATTEMPTS = 240;
+var POLL_INTERVAL_MS2 = 5e3;
+var DEFAULT_MAX_POLL_ATTEMPTS2 = 240;
 var BytePlusAdapter = class {
   providerName = "byteplus";
   supportedTypes = ["image", "video"];
@@ -1574,7 +1902,7 @@ var BytePlusAdapter = class {
       params,
       submittedAt: new Date(startedAt).toISOString()
     };
-    const maxAttempts = this.opts.maxPollAttempts ?? DEFAULT_MAX_POLL_ATTEMPTS;
+    const maxAttempts = this.opts.maxPollAttempts ?? DEFAULT_MAX_POLL_ATTEMPTS2;
     for (let attempt = 0; attempt < maxAttempts; attempt++) {
       const snapshot = await this.completeJob(job);
       if (snapshot.status === "failed") {
@@ -1583,7 +1911,7 @@ var BytePlusAdapter = class {
       if (snapshot.status === "succeeded" && snapshot.result) {
         return { ...snapshot.result, processingTimeMs: Date.now() - startedAt };
       }
-      await new Promise((resolve) => setTimeout(resolve, POLL_INTERVAL_MS));
+      await new Promise((resolve) => setTimeout(resolve, POLL_INTERVAL_MS2));
     }
     return failure(
       `Ark task ${taskId} did not finish after ${maxAttempts} checks.`
@@ -1860,8 +2188,8 @@ var ElevenLabsAdapter = class {
 // src/adapters/google.adapter.ts
 var DEFAULT_BASE_URL3 = "https://generativelanguage.googleapis.com";
 var INTERACTIONS_PATH = "/v1beta/interactions";
-var POLL_INTERVAL_MS2 = 1e4;
-var DEFAULT_MAX_POLL_ATTEMPTS2 = 120;
+var POLL_INTERVAL_MS3 = 1e4;
+var DEFAULT_MAX_POLL_ATTEMPTS3 = 120;
 var GoogleAdapter = class {
   providerName = "google";
   supportedTypes = [
@@ -2133,7 +2461,7 @@ var GoogleAdapter = class {
       params,
       submittedAt: new Date(startedAt).toISOString()
     };
-    const maxAttempts = this.opts.maxPollAttempts ?? DEFAULT_MAX_POLL_ATTEMPTS2;
+    const maxAttempts = this.opts.maxPollAttempts ?? DEFAULT_MAX_POLL_ATTEMPTS3;
     for (let attempt = 0; attempt < maxAttempts; attempt++) {
       const snapshot = await this.completeJob(job);
       if (snapshot.status === "failed") {
@@ -2142,7 +2470,7 @@ var GoogleAdapter = class {
       if (snapshot.status === "succeeded" && snapshot.result) {
         return { ...snapshot.result, processingTimeMs: Date.now() - startedAt };
       }
-      await new Promise((resolve) => setTimeout(resolve, POLL_INTERVAL_MS2));
+      await new Promise((resolve) => setTimeout(resolve, POLL_INTERVAL_MS3));
     }
     return failure(`Veo operation ${operation} did not finish in time.`);
   }
@@ -2357,8 +2685,8 @@ var GoogleAdapter = class {
 
 // src/adapters/kling.adapter.ts
 var DEFAULT_BASE_URL4 = "https://api-singapore.klingai.com";
-var POLL_INTERVAL_MS3 = 5e3;
-var DEFAULT_MAX_POLL_ATTEMPTS3 = 240;
+var POLL_INTERVAL_MS4 = 5e3;
+var DEFAULT_MAX_POLL_ATTEMPTS4 = 240;
 function stateOf(task) {
   const raw = (task.status ?? task.task_status ?? "").toLowerCase();
   if (raw === "failed") return "failed";
@@ -2555,7 +2883,7 @@ var KlingAdapter = class {
       params,
       submittedAt: new Date(startedAt).toISOString()
     };
-    const maxAttempts = this.opts.maxPollAttempts ?? DEFAULT_MAX_POLL_ATTEMPTS3;
+    const maxAttempts = this.opts.maxPollAttempts ?? DEFAULT_MAX_POLL_ATTEMPTS4;
     for (let attempt = 0; attempt < maxAttempts; attempt++) {
       const snapshot = await this.completeJob(job);
       if (snapshot.status === "failed") {
@@ -2564,7 +2892,7 @@ var KlingAdapter = class {
       if (snapshot.status === "succeeded" && snapshot.result) {
         return { ...snapshot.result, processingTimeMs: Date.now() - startedAt };
       }
-      await new Promise((resolve) => setTimeout(resolve, POLL_INTERVAL_MS3));
+      await new Promise((resolve) => setTimeout(resolve, POLL_INTERVAL_MS4));
     }
     return failure(
       `Kling task ${submitted.taskId} did not finish after ${maxAttempts} checks.`
@@ -2935,8 +3263,8 @@ var OpenAIAdapter = class {
 // src/adapters/qwen.adapter.ts
 var DEFAULT_BASE_URL6 = "https://dashscope-intl.aliyuncs.com";
 var TASKS_PATH2 = "/api/v1/tasks";
-var POLL_INTERVAL_MS4 = 5e3;
-var DEFAULT_MAX_POLL_ATTEMPTS4 = 240;
+var POLL_INTERVAL_MS5 = 5e3;
+var DEFAULT_MAX_POLL_ATTEMPTS5 = 240;
 var QwenAdapter = class {
   providerName = "qwen";
   supportedTypes = ["image", "video"];
@@ -3143,7 +3471,7 @@ var QwenAdapter = class {
       params,
       submittedAt: new Date(startedAt).toISOString()
     };
-    const maxAttempts = this.opts.maxPollAttempts ?? DEFAULT_MAX_POLL_ATTEMPTS4;
+    const maxAttempts = this.opts.maxPollAttempts ?? DEFAULT_MAX_POLL_ATTEMPTS5;
     for (let attempt = 0; attempt < maxAttempts; attempt++) {
       const snapshot = await this.completeJob(job);
       if (snapshot.status === "failed") {
@@ -3152,7 +3480,7 @@ var QwenAdapter = class {
       if (snapshot.status === "succeeded" && snapshot.result) {
         return { ...snapshot.result, processingTimeMs: Date.now() - startedAt };
       }
-      await new Promise((resolve) => setTimeout(resolve, POLL_INTERVAL_MS4));
+      await new Promise((resolve) => setTimeout(resolve, POLL_INTERVAL_MS5));
     }
     return failure(
       `DashScope task ${taskId} did not finish after ${maxAttempts} checks.`
@@ -3534,6 +3862,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",
@@ -3544,10 +3911,17 @@ var NATIVE_PROVIDERS = [
   "qwen"
 ];
 function brotuClient(options) {
-  if (Object.keys(options.providers).length === 0) {
-    throw new Error("brotuClient requires at least one provider API key.");
+  const apiKey = options.apiKey?.trim();
+  if (!apiKey) {
+    throw new Error(
+      "Pass a Brotu API key (brotu_sk_\u2026). Get one at https://brotu.app."
+    );
   }
+  const optionsWithKey = { ...options, apiKey };
+  const vendors = optionsWithKey.providers ?? {};
   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();
@@ -3568,7 +3942,7 @@ function brotuClient(options) {
     }
     let provider;
     try {
-      provider = resolveProvider(modelId, options);
+      provider = resolveProvider(modelId, optionsWithKey);
     } catch (error) {
       return failFrom("missing_key", error, { model: modelId });
     }
@@ -3589,6 +3963,13 @@ function brotuClient(options) {
     return ok({ adapter, provider: provider.id, model: modelId });
   }
   function buildAdapter(provider) {
+    if (provider.id === "brotu") {
+      return new BrotuAdapter({
+        apiKey,
+        apiUrl: optionsWithKey.apiUrl,
+        workspaceId: optionsWithKey.workspaceId
+      });
+    }
     if (provider.id === "kling") {
       return new KlingAdapter({
         apiKey: provider.apiKey,
@@ -3637,6 +4018,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({
@@ -3659,15 +4065,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) {
@@ -3686,18 +4127,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, {
@@ -3712,11 +4175,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);
@@ -3729,7 +4235,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,
@@ -3738,7 +4244,7 @@ function brotuClient(options) {
     }
   }
   function klingNamespace() {
-    const configured = options.providers.kling;
+    const configured = vendors.kling;
     if (!configured) return void 0;
     const adapter = new KlingAdapter({
       apiKey: configured.apiKey,
@@ -3763,7 +4269,7 @@ function brotuClient(options) {
     };
   }
   function googleNamespace() {
-    const configured = options.providers.google;
+    const configured = vendors.google;
     if (!configured) return void 0;
     const adapter = new GoogleAdapter({
       apiKey: configured.apiKey,
@@ -3798,6 +4304,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) => {
@@ -3807,7 +4324,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({
@@ -3829,7 +4352,7 @@ function brotuClient(options) {
         }
       }
     },
-    models: () => getAvailableModels(options),
+    models: () => getAvailableModels(optionsWithKey),
     estimateCost: async (type, params) => {
       const routed = route(params.model);
       if (routed.error) return fail(routed.error);
@@ -3848,7 +4371,9 @@ function brotuClient(options) {
 0 && (module.exports = {
   BYTEPLUS_CATALOG,
   BYTEPLUS_MODELS,
+  BrotuAdapter,
   BytePlusAdapter,
+  DEFAULT_BROTU_API_URL,
   ELEVENLABS_CATALOG,
   ELEVENLABS_MODELS,
   ELEVENLABS_OUTPUT_FORMATS,
@@ -3877,6 +4402,7 @@ function brotuClient(options) {
   QwenAdapter,
   brotuClient,
   createS3Storage,
+  deliverWebhook,
   fail,
   getAvailableModels,
   getModel,
@@ -3888,5 +4414,6 @@ function brotuClient(options) {
   persistOutputs,
   registerModels,
   resetCatalog,
-  resolveProvider
+  resolveProvider,
+  resolveWebhook
 });