@brotu/ai 0.2.0 → 0.3.0

package/README.md

@@ -55,6 +55,10 @@ 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,
+  },
 });
 ```
 
@@ -69,6 +73,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) |
@@ -156,6 +161,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/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.

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":"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"}

package/dist/index.cjs

@@ -61,6 +61,7 @@ __export(index_exports, {
   QwenAdapter: () => QwenAdapter,
   brotuClient: () => brotuClient,
   createS3Storage: () => createS3Storage,
+  deliverWebhook: () => deliverWebhook,
   fail: () => fail,
   getAvailableModels: () => getAvailableModels,
   getModel: () => getModel,
@@ -72,7 +73,8 @@ __export(index_exports, {
   persistOutputs: () => persistOutputs,
   registerModels: () => registerModels,
   resetCatalog: () => resetCatalog,
-  resolveProvider: () => resolveProvider
+  resolveProvider: () => resolveProvider,
+  resolveWebhook: () => resolveWebhook
 });
 module.exports = __toCommonJS(index_exports);
 
@@ -3534,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",
@@ -3548,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();
@@ -3637,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({
@@ -3659,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) {
@@ -3686,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, {
@@ -3712,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);
@@ -3729,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,
@@ -3798,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) => {
@@ -3807,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({
@@ -3877,6 +4062,7 @@ function brotuClient(options) {
   QwenAdapter,
   brotuClient,
   createS3Storage,
+  deliverWebhook,
   fail,
   getAvailableModels,
   getModel,
@@ -3888,5 +4074,6 @@ function brotuClient(options) {
   persistOutputs,
   registerModels,
   resetCatalog,
-  resolveProvider
+  resolveProvider,
+  resolveWebhook
 });

package/dist/index.d.ts

@@ -17,6 +17,7 @@ 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";

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,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"}
+{"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

@@ -2256,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",
@@ -2270,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();
@@ -2359,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({
@@ -2381,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) {
@@ -2408,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, {
@@ -2434,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);
@@ -2451,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,
@@ -2520,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) => {
@@ -2529,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({
@@ -2598,6 +2781,7 @@ export {
   QwenAdapter,
   brotuClient,
   createS3Storage,
+  deliverWebhook,
   fail,
   getAvailableModels,
   getModel,
@@ -2609,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"}

package/dist/ports/content-generator.port.d.ts

@@ -1,4 +1,5 @@
 import type { BillingUnit } from "../constants/model.types";
+import type { WebhookConfig } from "../lib/webhook";
 /** Known values, kept open because providers disagree on spelling and units. */
 export type VideoResolution = "480p" | "580p" | "720p" | "768p" | "1080p" | "4k" | "480P" | "720P" | "1080P" | (string & {});
 export type ImageResolution = "1K" | "2K" | "4K" | (string & {});
@@ -23,6 +24,11 @@ export interface CommonGenerationParams {
      * overrides what the adapter would otherwise send.
      */
     providerOptions?: Record<string, Record<string, unknown>>;
+    /**
+     * Override the client-level webhook for this request. Same shape: a URL
+     * string or `{ url, secret }`. Not sent to the provider.
+     */
+    webhook?: string | WebhookConfig;
 }
 /**
  * Shared image parameters.

package/dist/ports/content-generator.port.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"content-generator.port.d.ts","sourceRoot":"","sources":["../../src/ports/content-generator.port.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"content-generator.port.d.ts","sourceRoot":"","sources":["../../src/ports/content-generator.port.ts"],"names":[],"mappings":"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"}

package/dist/types.d.ts

@@ -1,5 +1,6 @@
 import type { AIModelConfig } from "./constants/model.types";
 import type { S3StorageConfig } from "./lib/storage";
+import type { WebhookConfig } from "./lib/webhook";
 export interface ProviderConfig {
     apiKey: string;
     /** Defaults to the known base URL for the provider, when there is one. */
@@ -45,6 +46,12 @@ export interface BrotuAIOptions {
     elevenLabsVoiceId?: string;
     /** Extra models, or overrides of built-in ones, merged by id. */
     models?: AIModelConfig[];
+    /**
+     * URL (or `{ url, secret }`) the client POSTs when a generation settles.
+     * Fires from `generate`, `jobs.wait`, and a terminal `jobs.poll`. Change it
+     * later with `ai.webhook.set`. A per-request `webhook` on the params wins.
+     */
+    webhook?: string | WebhookConfig;
 }
 /** Resolved per-request routing: which host and key serve this model. */
 export interface ResolvedProvider {

package/dist/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAC7D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAErD,MAAM,WAAW,cAAc;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,0EAA0E;IAC1E,OAAO,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,kBAAkB;IAClC,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,cAAc;IAC9B,gFAAgF;IAChF,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;IAC1C,mFAAmF;IACnF,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB;;;OAGG;IACH,UAAU,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IAC9C;;;;OAIG;IACH,UAAU,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,kBAAkB,CAAC,CAAC;IAC1D;;;;OAIG;IACH,OAAO,CAAC,EAAE,eAAe,CAAC;IAC1B;;;OAGG;IACH,WAAW,CAAC,EAAE,CACb,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,KACZ,OAAO,CAAC,MAAM,CAAC,CAAC;IACrB;;;;OAIG;IACH,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,iEAAiE;IACjE,MAAM,CAAC,EAAE,aAAa,EAAE,CAAC;CACzB;AAED,yEAAyE;AACzE,MAAM,WAAW,gBAAgB;IAChC,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;CAChB"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAC7D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AACrD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAEnD,MAAM,WAAW,cAAc;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,0EAA0E;IAC1E,OAAO,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,kBAAkB;IAClC,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,cAAc;IAC9B,gFAAgF;IAChF,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;IAC1C,mFAAmF;IACnF,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB;;;OAGG;IACH,UAAU,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IAC9C;;;;OAIG;IACH,UAAU,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,kBAAkB,CAAC,CAAC;IAC1D;;;;OAIG;IACH,OAAO,CAAC,EAAE,eAAe,CAAC;IAC1B;;;OAGG;IACH,WAAW,CAAC,EAAE,CACb,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,KACZ,OAAO,CAAC,MAAM,CAAC,CAAC;IACrB;;;;OAIG;IACH,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,iEAAiE;IACjE,MAAM,CAAC,EAAE,aAAa,EAAE,CAAC;IACzB;;;;OAIG;IACH,OAAO,CAAC,EAAE,MAAM,GAAG,aAAa,CAAC;CACjC;AAED,yEAAyE;AACzE,MAAM,WAAW,gBAAgB;IAChC,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;CAChB"}

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@brotu/ai",
-	"version": "0.2.0",
+	"version": "0.3.0",
 	"type": "module",
 	"main": "./dist/index.cjs",
 	"exports": {