@brotu/ai 0.4.0 → 0.5.0

package/README.md

@@ -23,7 +23,7 @@
   <a href="https://x.com/brotuApp">@brotuApp</a>
 </p>
 
-Kling, Seedance, Wan, Veo, Gemini, gpt-image and ElevenLabs all speak different HTTP. This package is one `brotuClient` in front of them.
+Kling, Seedance, Wan, Veo, Gemini, gpt-image and ElevenLabs all speak different HTTP. This package is one `brotu` in front of them.
 
 Get your key (`brotu_sk_…`) at [brotu.app](https://brotu.app). Pass a vendor key you already have and that model hits the vendor. Everything else generates on Brotu.
 
@@ -46,9 +46,9 @@ pnpm add @brotu/ai
 ## Client
 
 ```ts
-import { brotuClient } from "@brotu/ai";
+import { brotu } from "@brotu/ai";
 
-const ai = brotuClient({
+const ai = brotu({
   apiKey: process.env.BROTU_API_KEY!, // brotu_sk_… from https://brotu.app
   providers: {
     kling: { apiKey: process.env.KLING_API_KEY! },
@@ -71,18 +71,36 @@ Every public call returns `{ data, error }`. `data` is unusable until you narrow
 
 | Surface | Methods |
 |---|---|
-| `ai.video` | `submit` / `generate` |
-| `ai.image` | `submit` / `generate` |
-| `ai.text` | `submit` / `generate` |
-| `ai.audio` | `submit` / `generate` |
+| `ai.video` | `submit` / `generate` / `list` |
+| `ai.image` | `submit` / `generate` / `list` |
+| `ai.text` | `submit` / `generate` / `list` |
+| `ai.audio` | `submit` / `generate` / `list` |
 | `ai.jobs` | `poll` / `wait` |
 | `ai.webhook` | `set` / `clear` / `get` |
+| `hooks` | constructor option: your own code on start, success and failure |
 | `ai.estimateCost` | units, and USD when verified |
 | `ai.kling` | `motionControl`, `omniVideo`, `avatar`, `outpainting`, `imageOmni` |
 | `ai.google` | `omniVideo` (conversational refine) |
 
 `ai.kling` and `ai.google` exist only when that key is set.
 
+## What your keys reach
+
+The platform generates image and video. Speech and text are the vendor's work, so those need that vendor's key. `list` says which is which, per model:
+
+```ts
+const ai = brotu({ apiKey: process.env.BROTU_API_KEY! });
+
+ai.image.list();
+// [{ model: { id: "gpt-image-2", … }, runsOn: "brotu", runnable: true }, …]
+
+ai.audio.list();
+// [{ model: { id: "kling/tts", … }, runsOn: "kling", runnable: false,
+//    reason: "Brotu generates image and video only. Pass providers.kling to run this one." }, …]
+```
+
+With a Brotu key alone that is 29 image and 37 video models, and the 31 speech and text models listed with the key they are waiting on. Models you cannot reach stay in the list on purpose: hiding them would hide the gap. `ai.models()` is the filtered view, only what runs.
+
 ## Video
 
 `submit` returns a job handle. `generate` waits. Video takes minutes, so do not `generate` inside a request handler.
@@ -205,6 +223,26 @@ The POST is JSON. Check `x-brotu-event` and, if you set a secret, `x-brotu-webho
 
 Error codes: `unknown_model`, `missing_key`, `unsupported_provider`, `invalid_request`, `provider_error`, `timeout`.
 
+## Hooks
+
+Same moments as the webhook, but a function instead of an endpoint — so it runs in your process, with your imports.
+
+```ts
+const ai = brotu({
+  apiKey: process.env.BROTU_API_KEY!,
+  providers: { kling: { apiKey: process.env.KLING_API_KEY! } },
+  hooks: {
+    onVideoLoading: (e) => console.log("generating", e.model),
+    onVideoSuccess: (e) => sendEmail("your video is ready", e.outputs?.[0]?.url),
+    onVideoError: (e) => sendEmail("your video failed", e.error?.message),
+  },
+});
+```
+
+One optional callback per kind and stage — `on{Image,Video,Audio,Text}{Loading,Success,Error}`, twelve typed names. `Loading` fires once the model is routed, before the provider is called; `Success` and `Error` fire wherever the webhook fires, deduped by job id. A hook that throws never fails the generation.
+
+The event is `HookEvent`: `kind`, `stage`, `provider`, `model`, `jobId`, `outputs`, `error`, `metadata`, `processingTimeMs`, `at`.
+
 ## Motion control, avatars, omni
 
 Not on `ai.video`. A shared signature would be a lie.

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

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

package/dist/catalog.cjs

@@ -20,7 +20,9 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 // src/catalog.ts
 var catalog_exports = {};
 __export(catalog_exports, {
+  BROTU_SUPPORTED_CATEGORIES: () => BROTU_SUPPORTED_CATEGORIES,
   DEFAULT_BROTU_API_URL: () => DEFAULT_BROTU_API_URL,
+  describeModels: () => describeModels,
   getAvailableModels: () => getAvailableModels,
   getModel: () => getModel,
   getModels: () => getModels,
@@ -1084,18 +1086,50 @@ function resolveProvider(modelId, options) {
     `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));
-  }
+var BROTU_SUPPORTED_CATEGORIES = ["image", "video"];
+function describeModels(options) {
   const vendors = vendorProviders(options);
-  return catalog.filter(
-    (model) => model.provider && model.provider in vendors
-  );
+  const platformKey = brotuApiKey(options);
+  return catalog.map((model) => {
+    const provider = model.provider;
+    if (!provider) {
+      return {
+        model,
+        runsOn: "(none)",
+        runnable: false,
+        reason: "The model declares no provider."
+      };
+    }
+    if (provider in vendors) {
+      return { model, runsOn: provider, runnable: true };
+    }
+    if (platformKey) {
+      if (BROTU_SUPPORTED_CATEGORIES.includes(model.category)) {
+        return { model, runsOn: "brotu", runnable: true };
+      }
+      return {
+        model,
+        runsOn: provider,
+        runnable: false,
+        reason: `Brotu generates ${BROTU_SUPPORTED_CATEGORIES.join(" and ")} only. Pass providers.${provider} to run this one.`
+      };
+    }
+    return {
+      model,
+      runsOn: provider,
+      runnable: false,
+      reason: `No key for "${provider}". Pass a Brotu key or providers.${provider}.`
+    };
+  });
+}
+function getAvailableModels(options) {
+  return describeModels(options).filter((entry) => entry.runnable).map((entry) => entry.model);
 }
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
+  BROTU_SUPPORTED_CATEGORIES,
   DEFAULT_BROTU_API_URL,
+  describeModels,
   getAvailableModels,
   getModel,
   getModels,

package/dist/catalog.d.ts

@@ -1,4 +1,4 @@
-import type { AIModelConfig } from "./constants/model.types";
+import type { AIModelCategory, AIModelConfig } from "./constants/model.types";
 import type { BrotuAIOptions, ResolvedProvider } from "./types";
 export declare const DEFAULT_BROTU_API_URL: string;
 /**
@@ -23,6 +23,27 @@ export declare function getProviders(): string[];
  * aggregator, so there is no wallet to guess between.
  */
 export declare function resolveProvider(modelId: string, options: BrotuAIOptions): ResolvedProvider;
+/**
+ * What the platform generates on credits. Speech and text are the vendor's
+ * work, so a Brotu key alone does not reach them. The Brotu adapter reads this
+ * too, so the catalog and the adapter cannot drift apart.
+ */
+export declare const BROTU_SUPPORTED_CATEGORIES: AIModelCategory[];
+/** A model plus where it would actually run with the keys at hand. */
+export interface ModelAvailability {
+    model: AIModelConfig;
+    /** Provider that serves it: a vendor id, or "brotu" for the platform. */
+    runsOn: string;
+    /** False when nothing configured can run it. `reason` says why. */
+    runnable: boolean;
+    reason?: string;
+}
+/**
+ * Every catalog model, each labelled with the host that would serve it. This is
+ * the honest view: `runnable: false` entries are the ones a key is missing for,
+ * and they stay in the list precisely so the caller can see what is missing.
+ */
+export declare function describeModels(options: BrotuAIOptions): ModelAvailability[];
 /** Models the caller can actually run, given the keys they supplied. */
 export declare function getAvailableModels(options: BrotuAIOptions): AIModelConfig[];
 //# sourceMappingURL=catalog.d.ts.map

package/dist/catalog.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"catalog.d.ts","sourceRoot":"","sources":["../src/catalog.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAU7D,OAAO,KAAK,EAAE,cAAc,EAAkB,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAgBhF,eAAO,MAAM,qBAAqB,QAA2B,CAAC;AA+B9D;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,MAAM,GAAE,aAAa,EAAO,GAAG,IAAI,CAUjE;AAED,0EAA0E;AAC1E,wBAAgB,YAAY,IAAI,IAAI,CAGnC;AAED,wBAAgB,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS,CAEnE;AAED,wBAAgB,SAAS,IAAI,aAAa,EAAE,CAE3C;AAED,wBAAgB,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAEjD;AAED,wDAAwD;AACxD,wBAAgB,YAAY,IAAI,MAAM,EAAE,CAQvC;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAC9B,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,cAAc,GACrB,gBAAgB,CAqClB;AAED,wEAAwE;AACxE,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,cAAc,GAAG,aAAa,EAAE,CAQ3E"}
+{"version":3,"file":"catalog.d.ts","sourceRoot":"","sources":["../src/catalog.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAU9E,OAAO,KAAK,EAAE,cAAc,EAAkB,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAgBhF,eAAO,MAAM,qBAAqB,QAA2B,CAAC;AA+B9D;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,MAAM,GAAE,aAAa,EAAO,GAAG,IAAI,CAUjE;AAED,0EAA0E;AAC1E,wBAAgB,YAAY,IAAI,IAAI,CAGnC;AAED,wBAAgB,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS,CAEnE;AAED,wBAAgB,SAAS,IAAI,aAAa,EAAE,CAE3C;AAED,wBAAgB,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAEjD;AAED,wDAAwD;AACxD,wBAAgB,YAAY,IAAI,MAAM,EAAE,CAQvC;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAC9B,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,cAAc,GACrB,gBAAgB,CAqClB;AAED;;;;GAIG;AACH,eAAO,MAAM,0BAA0B,EAAE,eAAe,EAAuB,CAAC;AAEhF,sEAAsE;AACtE,MAAM,WAAW,iBAAiB;IACjC,KAAK,EAAE,aAAa,CAAC;IACrB,yEAAyE;IACzE,MAAM,EAAE,MAAM,CAAC;IACf,mEAAmE;IACnE,QAAQ,EAAE,OAAO,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,cAAc,GAAG,iBAAiB,EAAE,CAmC3E;AAED,wEAAwE;AACxE,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,cAAc,GAAG,aAAa,EAAE,CAI3E"}

package/dist/catalog.js

@@ -1,5 +1,7 @@
 import {
+  BROTU_SUPPORTED_CATEGORIES,
   DEFAULT_BROTU_API_URL,
+  describeModels,
   getAvailableModels,
   getModel,
   getModels,
@@ -8,9 +10,11 @@ import {
   registerModels,
   resetCatalog,
   resolveProvider
-} from "./chunk-QOWHHKSI.js";
+} from "./chunk-3MC3RDAJ.js";
 export {
+  BROTU_SUPPORTED_CATEGORIES,
   DEFAULT_BROTU_API_URL,
+  describeModels,
   getAvailableModels,
   getModel,
   getModels,

package/dist/{chunk-QOWHHKSI.js → chunk-3MC3RDAJ.js}

@@ -1247,14 +1247,44 @@ function resolveProvider(modelId, options) {
     `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));
-  }
+var BROTU_SUPPORTED_CATEGORIES = ["image", "video"];
+function describeModels(options) {
   const vendors = vendorProviders(options);
-  return catalog.filter(
-    (model) => model.provider && model.provider in vendors
-  );
+  const platformKey = brotuApiKey(options);
+  return catalog.map((model) => {
+    const provider = model.provider;
+    if (!provider) {
+      return {
+        model,
+        runsOn: "(none)",
+        runnable: false,
+        reason: "The model declares no provider."
+      };
+    }
+    if (provider in vendors) {
+      return { model, runsOn: provider, runnable: true };
+    }
+    if (platformKey) {
+      if (BROTU_SUPPORTED_CATEGORIES.includes(model.category)) {
+        return { model, runsOn: "brotu", runnable: true };
+      }
+      return {
+        model,
+        runsOn: provider,
+        runnable: false,
+        reason: `Brotu generates ${BROTU_SUPPORTED_CATEGORIES.join(" and ")} only. Pass providers.${provider} to run this one.`
+      };
+    }
+    return {
+      model,
+      runsOn: provider,
+      runnable: false,
+      reason: `No key for "${provider}". Pass a Brotu key or providers.${provider}.`
+    };
+  });
+}
+function getAvailableModels(options) {
+  return describeModels(options).filter((entry) => entry.runnable).map((entry) => entry.model);
 }
 
 export {
@@ -1294,5 +1324,7 @@ export {
   hasModel,
   getProviders,
   resolveProvider,
+  BROTU_SUPPORTED_CATEGORIES,
+  describeModels,
   getAvailableModels
 };

package/dist/client.d.ts

@@ -1,4 +1,4 @@
-import { getModel } from "./catalog";
+import { getModel, type ModelAvailability } 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";
@@ -14,19 +14,30 @@ export interface BrotuAI {
         submit(params: ImageGenerationParams): Promise<Result<Job>>;
         /** submit + wait. Convenient, but holds the call open for the whole run. */
         generate(params: ImageGenerationParams): Promise<Result<Generation>>;
+        /**
+         * Every image model, each labelled with the host that would serve it
+         * (`runsOn`) and whether your keys reach it (`runnable`). Unreachable
+         * models stay in the list, with `reason`, so the gap is visible.
+         */
+        list(): ModelAvailability[];
     };
     video: {
         submit(params: VideoGenerationParams): Promise<Result<Job>>;
         generate(params: VideoGenerationParams): Promise<Result<Generation>>;
+        list(): ModelAvailability[];
     };
     text: {
         submit(params: TextGenerationParams): Promise<Result<Job>>;
         generate(params: TextGenerationParams): Promise<Result<Generation>>;
+        /** Text runs on the vendor, so these need `providers`, not a Brotu key. */
+        list(): ModelAvailability[];
     };
     /** Speech synthesis. `prompt` is the text to speak. */
     audio: {
         submit(params: AudioGenerationParams): Promise<Result<Job>>;
         generate(params: AudioGenerationParams): Promise<Result<Generation>>;
+        /** Speech runs on the vendor, so these need `providers`, not a Brotu key. */
+        list(): ModelAvailability[];
     };
     jobs: {
         /** Ask once. Returns straight away, settled or not. */
@@ -90,7 +101,7 @@ export interface BrotuAI {
      */
     estimateCost(type: GenerationType, params: GenerationParams): Promise<Result<CostEstimate>>;
 }
-export declare function brotuClient(options: BrotuAIOptions): BrotuAI;
+export declare function brotu(options: BrotuAIOptions): BrotuAI;
 export type { AIError, Generation, Result };
 export { getModel };
 //# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

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

package/dist/index.cjs

@@ -30,6 +30,7 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 // src/index.ts
 var index_exports = {};
 __export(index_exports, {
+  BROTU_SUPPORTED_CATEGORIES: () => BROTU_SUPPORTED_CATEGORIES,
   BYTEPLUS_CATALOG: () => BYTEPLUS_CATALOG,
   BYTEPLUS_MODELS: () => BYTEPLUS_MODELS,
   BrotuAdapter: () => BrotuAdapter,
@@ -61,9 +62,10 @@ __export(index_exports, {
   QWEN_TEXT_MODELS: () => QWEN_TEXT_MODELS,
   QWEN_VIDEO_MODELS: () => QWEN_VIDEO_MODELS,
   QwenAdapter: () => QwenAdapter,
-  brotuClient: () => brotuClient,
+  brotu: () => brotu,
   createS3Storage: () => createS3Storage,
   deliverWebhook: () => deliverWebhook,
+  describeModels: () => describeModels,
   fail: () => fail,
   getAvailableModels: () => getAvailableModels,
   getModel: () => getModel,
@@ -80,34 +82,6 @@ __export(index_exports, {
 });
 module.exports = __toCommonJS(index_exports);
 
-// src/lib/jobs.ts
-var import_node_async_hooks = require("async_hooks");
-var PendingJob = class extends Error {
-  taskId;
-  pollEndpoint;
-  constructor(taskId, pollEndpoint) {
-    super(`Job ${taskId} was submitted and is still running.`);
-    this.name = "PendingJob";
-    this.taskId = taskId;
-    this.pollEndpoint = pollEndpoint;
-  }
-};
-function isPendingJob(error) {
-  return error instanceof PendingJob;
-}
-var submitMode = new import_node_async_hooks.AsyncLocalStorage();
-function runInSubmitMode(fn) {
-  return submitMode.run(true, fn);
-}
-function isSubmitMode() {
-  return submitMode.getStore() === true;
-}
-
-// src/ports/content-generator.port.ts
-function expiresInHours(hours) {
-  return new Date(Date.now() + hours * 36e5).toISOString();
-}
-
 // src/providers/byteplus.models.ts
 var FPS = 24;
 var PIXELS = {
@@ -1357,14 +1331,72 @@ function resolveProvider(modelId, options) {
     `Model "${modelId}" runs on "${id}", but no API key was given for it (configured: ${owned}). Pass a Brotu key to generate on the platform.`
   );
 }
+var BROTU_SUPPORTED_CATEGORIES = ["image", "video"];
+function describeModels(options) {
+  const vendors = vendorProviders(options);
+  const platformKey = brotuApiKey(options);
+  return catalog.map((model) => {
+    const provider = model.provider;
+    if (!provider) {
+      return {
+        model,
+        runsOn: "(none)",
+        runnable: false,
+        reason: "The model declares no provider."
+      };
+    }
+    if (provider in vendors) {
+      return { model, runsOn: provider, runnable: true };
+    }
+    if (platformKey) {
+      if (BROTU_SUPPORTED_CATEGORIES.includes(model.category)) {
+        return { model, runsOn: "brotu", runnable: true };
+      }
+      return {
+        model,
+        runsOn: provider,
+        runnable: false,
+        reason: `Brotu generates ${BROTU_SUPPORTED_CATEGORIES.join(" and ")} only. Pass providers.${provider} to run this one.`
+      };
+    }
+    return {
+      model,
+      runsOn: provider,
+      runnable: false,
+      reason: `No key for "${provider}". Pass a Brotu key or providers.${provider}.`
+    };
+  });
+}
 function getAvailableModels(options) {
-  if (brotuApiKey(options)) {
-    return catalog.filter((model) => Boolean(model.provider));
+  return describeModels(options).filter((entry) => entry.runnable).map((entry) => entry.model);
+}
+
+// src/lib/jobs.ts
+var import_node_async_hooks = require("async_hooks");
+var PendingJob = class extends Error {
+  taskId;
+  pollEndpoint;
+  constructor(taskId, pollEndpoint) {
+    super(`Job ${taskId} was submitted and is still running.`);
+    this.name = "PendingJob";
+    this.taskId = taskId;
+    this.pollEndpoint = pollEndpoint;
   }
-  const vendors = vendorProviders(options);
-  return catalog.filter(
-    (model) => model.provider && model.provider in vendors
-  );
+};
+function isPendingJob(error) {
+  return error instanceof PendingJob;
+}
+var submitMode = new import_node_async_hooks.AsyncLocalStorage();
+function runInSubmitMode(fn) {
+  return submitMode.run(true, fn);
+}
+function isSubmitMode() {
+  return submitMode.getStore() === true;
+}
+
+// src/ports/content-generator.port.ts
+function expiresInHours(hours) {
+  return new Date(Date.now() + hours * 36e5).toISOString();
 }
 
 // src/adapters/estimate.ts
@@ -1412,7 +1444,7 @@ var BrotuAdapter = class {
   }
   opts;
   providerName = "brotu";
-  supportedTypes = ["image", "video"];
+  supportedTypes = BROTU_SUPPORTED_CATEGORIES;
   workspaceIdCache;
   get origin() {
     return (this.opts.apiUrl ?? DEFAULT_API_URL).replace(/\/$/, "");
@@ -3740,6 +3772,22 @@ function failFrom(code, cause, context) {
   });
 }
 
+// src/lib/hooks.ts
+function hookName(kind, stage) {
+  return `on${kind[0].toUpperCase()}${kind.slice(1)}${stage}`;
+}
+function findHook(hooks, kind, stage) {
+  if (!hooks || !kind) return void 0;
+  return hooks[hookName(kind, stage)];
+}
+async function runHook(hook, event) {
+  if (!hook) return;
+  try {
+    await hook(event);
+  } catch {
+  }
+}
+
 // src/lib/storage.ts
 async function loadS3(config) {
   let s3;
@@ -3910,7 +3958,7 @@ var NATIVE_PROVIDERS = [
   "openai",
   "qwen"
 ];
-function brotuClient(options) {
+function brotu(options) {
   const apiKey = options.apiKey?.trim();
   if (!apiKey) {
     throw new Error(
@@ -4023,7 +4071,10 @@ function brotuClient(options) {
   }
   async function notifySettled(input) {
     const config = webhookFor(input.params);
-    if (!config) return;
+    const kind = input.kind ?? input.job?.kind;
+    const stage = input.event === "generation.succeeded" ? "Success" : "Error";
+    const hook = findHook(options.hooks, kind, stage);
+    if (!config && !hook) return;
     const jobId = input.job?.id;
     if (jobId) {
       if (notifiedJobIds.has(jobId)) return;
@@ -4034,14 +4085,38 @@ function brotuClient(options) {
       jobId,
       provider: input.provider ?? input.job?.provider,
       model: input.model ?? input.job?.model,
-      kind: input.kind ?? input.job?.kind,
+      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);
+    if (hook && kind) {
+      await runHook(hook, {
+        kind,
+        stage,
+        provider: payload.provider ?? "",
+        model: payload.model ?? "",
+        jobId: payload.jobId,
+        outputs: payload.outputs,
+        error: payload.error,
+        metadata: payload.metadata,
+        processingTimeMs: payload.processingTimeMs,
+        at: payload.completedAt
+      });
+    }
+    if (config) await deliverWebhook(config, payload);
+  }
+  function notifyLoading(kind, routed, params) {
+    return runHook(findHook(options.hooks, kind, "Loading"), {
+      kind,
+      stage: "Loading",
+      provider: routed.provider,
+      model: routed.model,
+      metadata: params.metadata,
+      at: (/* @__PURE__ */ new Date()).toISOString()
+    });
   }
   async function toGeneration(raw, metadata) {
     if (!raw.success) {
@@ -4064,6 +4139,7 @@ function brotuClient(options) {
   async function generate(kind, params) {
     const routed = route(params.model);
     if (routed.error) return fail(routed.error);
+    await notifyLoading(kind, routed.data, params);
     try {
       const result = await toGeneration(
         await generateWith(routed.data.adapter, kind, params),
@@ -4114,6 +4190,7 @@ function brotuClient(options) {
   async function submit(kind, params) {
     const routed = route(params.model);
     if (routed.error) return fail(routed.error);
+    await notifyLoading(kind, routed.data, params);
     const base = {
       provider: routed.data.provider,
       model: routed.data.model,
@@ -4285,24 +4362,33 @@ function brotuClient(options) {
       }
     };
   }
+  function listFor(category) {
+    return describeModels(optionsWithKey).filter(
+      (entry) => entry.model.category === category
+    );
+  }
   return {
     google: googleNamespace(),
     kling: klingNamespace(),
     image: {
       submit: (params) => submit("image", params),
-      generate: (params) => generate("image", params)
+      generate: (params) => generate("image", params),
+      list: () => listFor("image")
     },
     video: {
       submit: (params) => submit("video", params),
-      generate: (params) => generate("video", params)
+      generate: (params) => generate("video", params),
+      list: () => listFor("video")
     },
     text: {
       submit: (params) => submit("text", params),
-      generate: (params) => generate("text", params)
+      generate: (params) => generate("text", params),
+      list: () => listFor("text")
     },
     audio: {
       submit: (params) => submit("audio", params),
-      generate: (params) => generate("audio", params)
+      generate: (params) => generate("audio", params),
+      list: () => listFor("audio")
     },
     webhook: {
       set(value) {
@@ -4369,6 +4455,7 @@ function brotuClient(options) {
 }
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
+  BROTU_SUPPORTED_CATEGORIES,
   BYTEPLUS_CATALOG,
   BYTEPLUS_MODELS,
   BrotuAdapter,
@@ -4400,9 +4487,10 @@ function brotuClient(options) {
   QWEN_TEXT_MODELS,
   QWEN_VIDEO_MODELS,
   QwenAdapter,
-  brotuClient,
+  brotu,
   createS3Storage,
   deliverWebhook,
+  describeModels,
   fail,
   getAvailableModels,
   getModel,

package/dist/index.d.ts

@@ -12,11 +12,13 @@ export type { OpenAIAdapterOptions } from "./adapters/openai.adapter";
 export { OpenAIAdapter } from "./adapters/openai.adapter";
 export type { QwenAdapterOptions } from "./adapters/qwen.adapter";
 export { QwenAdapter } from "./adapters/qwen.adapter";
-export { DEFAULT_BROTU_API_URL, getAvailableModels, getModel, getModels, getProviders, hasModel, registerModels, resetCatalog, resolveProvider, } from "./catalog";
+export type { ModelAvailability } from "./catalog";
+export { BROTU_SUPPORTED_CATEGORIES, DEFAULT_BROTU_API_URL, describeModels, getAvailableModels, getModel, getModels, getProviders, hasModel, registerModels, resetCatalog, resolveProvider, } from "./catalog";
 export type { BrotuAI } from "./client";
-export { brotuClient } from "./client";
+export { brotu } from "./client";
 export type * from "./constants/model.types";
 export { type AIError, type AIErrorCode, fail, type Generation, ok, type Result, } from "./helpers/result";
+export type { HookEvent, HookFn, Hooks, HookStage, } from "./lib/hooks";
 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";

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AACpE,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AACxD,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,qBAAqB,EACrB,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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/index.js

@@ -1,4 +1,5 @@
 import {
+  BROTU_SUPPORTED_CATEGORIES,
   BYTEPLUS_CATALOG,
   BYTEPLUS_IMAGE_MODELS,
   BYTEPLUS_MODELS,
@@ -26,6 +27,7 @@ import {
   QWEN_IMAGE_PATHS,
   QWEN_TEXT_MODELS,
   QWEN_VIDEO_MODELS,
+  describeModels,
   fieldsFor,
   getAvailableModels,
   getModel,
@@ -36,7 +38,7 @@ import {
   resetCatalog,
   resolveProvider,
   videoPathFor
-} from "./chunk-QOWHHKSI.js";
+} from "./chunk-3MC3RDAJ.js";
 
 // src/lib/jobs.ts
 import { AsyncLocalStorage } from "async_hooks";
@@ -111,7 +113,7 @@ var BrotuAdapter = class {
   }
   opts;
   providerName = "brotu";
-  supportedTypes = ["image", "video"];
+  supportedTypes = BROTU_SUPPORTED_CATEGORIES;
   workspaceIdCache;
   get origin() {
     return (this.opts.apiUrl ?? DEFAULT_API_URL).replace(/\/$/, "");
@@ -2439,6 +2441,22 @@ function failFrom(code, cause, context) {
   });
 }
 
+// src/lib/hooks.ts
+function hookName(kind, stage) {
+  return `on${kind[0].toUpperCase()}${kind.slice(1)}${stage}`;
+}
+function findHook(hooks, kind, stage) {
+  if (!hooks || !kind) return void 0;
+  return hooks[hookName(kind, stage)];
+}
+async function runHook(hook, event) {
+  if (!hook) return;
+  try {
+    await hook(event);
+  } catch {
+  }
+}
+
 // src/lib/storage.ts
 async function loadS3(config) {
   let s3;
@@ -2609,7 +2627,7 @@ var NATIVE_PROVIDERS = [
   "openai",
   "qwen"
 ];
-function brotuClient(options) {
+function brotu(options) {
   const apiKey = options.apiKey?.trim();
   if (!apiKey) {
     throw new Error(
@@ -2722,7 +2740,10 @@ function brotuClient(options) {
   }
   async function notifySettled(input) {
     const config = webhookFor(input.params);
-    if (!config) return;
+    const kind = input.kind ?? input.job?.kind;
+    const stage = input.event === "generation.succeeded" ? "Success" : "Error";
+    const hook = findHook(options.hooks, kind, stage);
+    if (!config && !hook) return;
     const jobId = input.job?.id;
     if (jobId) {
       if (notifiedJobIds.has(jobId)) return;
@@ -2733,14 +2754,38 @@ function brotuClient(options) {
       jobId,
       provider: input.provider ?? input.job?.provider,
       model: input.model ?? input.job?.model,
-      kind: input.kind ?? input.job?.kind,
+      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);
+    if (hook && kind) {
+      await runHook(hook, {
+        kind,
+        stage,
+        provider: payload.provider ?? "",
+        model: payload.model ?? "",
+        jobId: payload.jobId,
+        outputs: payload.outputs,
+        error: payload.error,
+        metadata: payload.metadata,
+        processingTimeMs: payload.processingTimeMs,
+        at: payload.completedAt
+      });
+    }
+    if (config) await deliverWebhook(config, payload);
+  }
+  function notifyLoading(kind, routed, params) {
+    return runHook(findHook(options.hooks, kind, "Loading"), {
+      kind,
+      stage: "Loading",
+      provider: routed.provider,
+      model: routed.model,
+      metadata: params.metadata,
+      at: (/* @__PURE__ */ new Date()).toISOString()
+    });
   }
   async function toGeneration(raw, metadata) {
     if (!raw.success) {
@@ -2763,6 +2808,7 @@ function brotuClient(options) {
   async function generate(kind, params) {
     const routed = route(params.model);
     if (routed.error) return fail(routed.error);
+    await notifyLoading(kind, routed.data, params);
     try {
       const result = await toGeneration(
         await generateWith(routed.data.adapter, kind, params),
@@ -2813,6 +2859,7 @@ function brotuClient(options) {
   async function submit(kind, params) {
     const routed = route(params.model);
     if (routed.error) return fail(routed.error);
+    await notifyLoading(kind, routed.data, params);
     const base = {
       provider: routed.data.provider,
       model: routed.data.model,
@@ -2984,24 +3031,33 @@ function brotuClient(options) {
       }
     };
   }
+  function listFor(category) {
+    return describeModels(optionsWithKey).filter(
+      (entry) => entry.model.category === category
+    );
+  }
   return {
     google: googleNamespace(),
     kling: klingNamespace(),
     image: {
       submit: (params) => submit("image", params),
-      generate: (params) => generate("image", params)
+      generate: (params) => generate("image", params),
+      list: () => listFor("image")
     },
     video: {
       submit: (params) => submit("video", params),
-      generate: (params) => generate("video", params)
+      generate: (params) => generate("video", params),
+      list: () => listFor("video")
     },
     text: {
       submit: (params) => submit("text", params),
-      generate: (params) => generate("text", params)
+      generate: (params) => generate("text", params),
+      list: () => listFor("text")
     },
     audio: {
       submit: (params) => submit("audio", params),
-      generate: (params) => generate("audio", params)
+      generate: (params) => generate("audio", params),
+      list: () => listFor("audio")
     },
     webhook: {
       set(value) {
@@ -3067,6 +3123,7 @@ function brotuClient(options) {
   };
 }
 export {
+  BROTU_SUPPORTED_CATEGORIES,
   BYTEPLUS_CATALOG,
   BYTEPLUS_MODELS,
   BrotuAdapter,
@@ -3098,9 +3155,10 @@ export {
   QWEN_TEXT_MODELS,
   QWEN_VIDEO_MODELS,
   QwenAdapter,
-  brotuClient,
+  brotu,
   createS3Storage,
   deliverWebhook,
+  describeModels,
   fail,
   getAvailableModels,
   getModel,

package/dist/lib/hooks.d.ts

@@ -0,0 +1,32 @@
+import type { AIError } from "../helpers/result";
+import type { GenerationOutput, GenerationType } from "../ports/content-generator.port";
+/** Where a generation is when the hook fires. */
+export type HookStage = "Loading" | "Success" | "Error";
+/** What every hook receives. Fields absent at that stage stay undefined. */
+export interface HookEvent {
+    kind: GenerationType;
+    stage: HookStage;
+    provider: string;
+    model: string;
+    jobId?: string;
+    outputs?: GenerationOutput[];
+    error?: Pick<AIError, "code" | "message">;
+    metadata?: Record<string, string>;
+    processingTimeMs?: number;
+    at: string;
+}
+export type HookFn = (event: HookEvent) => void | Promise<void>;
+/**
+ * One optional callback per kind and stage — `onVideoLoading`,
+ * `onImageSuccess`, `onAudioError`, and so on for every combination.
+ */
+export type Hooks = Partial<Record<`on${Capitalize<GenerationType>}${HookStage}`, HookFn>>;
+/** The hook registered for this kind and stage, if any. */
+export declare function findHook(hooks: Hooks | undefined, kind: GenerationType | undefined, stage: HookStage): HookFn | undefined;
+/**
+ * Run a hook without letting it break the caller. Same contract as the
+ * webhook: your logging or your mailer going down must not fail a generation
+ * that already succeeded.
+ */
+export declare function runHook(hook: HookFn | undefined, event: HookEvent): Promise<void>;
+//# sourceMappingURL=hooks.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"hooks.d.ts","sourceRoot":"","sources":["../../src/lib/hooks.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,KAAK,EACX,gBAAgB,EAChB,cAAc,EACd,MAAM,iCAAiC,CAAC;AAEzC,iDAAiD;AACjD,MAAM,MAAM,SAAS,GAAG,SAAS,GAAG,SAAS,GAAG,OAAO,CAAC;AAExD,4EAA4E;AAC5E,MAAM,WAAW,SAAS;IACzB,IAAI,EAAE,cAAc,CAAC;IACrB,KAAK,EAAE,SAAS,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,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,EAAE,EAAE,MAAM,CAAC;CACX;AAED,MAAM,MAAM,MAAM,GAAG,CAAC,KAAK,EAAE,SAAS,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;AAEhE;;;GAGG;AACH,MAAM,MAAM,KAAK,GAAG,OAAO,CAC1B,MAAM,CAAC,KAAK,UAAU,CAAC,cAAc,CAAC,GAAG,SAAS,EAAE,EAAE,MAAM,CAAC,CAC7D,CAAC;AAMF,2DAA2D;AAC3D,wBAAgB,QAAQ,CACvB,KAAK,EAAE,KAAK,GAAG,SAAS,EACxB,IAAI,EAAE,cAAc,GAAG,SAAS,EAChC,KAAK,EAAE,SAAS,GACd,MAAM,GAAG,SAAS,CAGpB;AAED;;;;GAIG;AACH,wBAAsB,OAAO,CAC5B,IAAI,EAAE,MAAM,GAAG,SAAS,EACxB,KAAK,EAAE,SAAS,GACd,OAAO,CAAC,IAAI,CAAC,CAOf"}

package/dist/types.d.ts

@@ -1,4 +1,5 @@
 import type { AIModelConfig } from "./constants/model.types";
+import type { Hooks } from "./lib/hooks";
 import type { S3StorageConfig } from "./lib/storage";
 import type { WebhookConfig } from "./lib/webhook";
 export interface ProviderConfig {
@@ -64,6 +65,14 @@ export interface BrotuAIOptions {
      * later with `ai.webhook.set`. A per-request `webhook` on the params wins.
      */
     webhook?: string | WebhookConfig;
+    /**
+     * In-process callbacks, one per kind and stage: `onVideoLoading`,
+     * `onVideoSuccess`, `onVideoError`, and the same three for image, audio and
+     * text. Your logic runs inside your process, so it can send an email, write
+     * to your DB or push to a queue — no endpoint needed, unlike `webhook`.
+     * Throwing inside a hook never fails the generation.
+     */
+    hooks?: Hooks;
 }
 /** 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;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;;;OAGG;IACH,MAAM,EAAE,MAAM,CAAC;IACf,6DAA6D;IAC7D,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,yEAAyE;IACzE,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;IAC3C,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"}
+{"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,KAAK,EAAE,MAAM,aAAa,CAAC;AACzC,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;;;OAGG;IACH,MAAM,EAAE,MAAM,CAAC;IACf,6DAA6D;IAC7D,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,yEAAyE;IACzE,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;IAC3C,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;IACjC;;;;;;OAMG;IACH,KAAK,CAAC,EAAE,KAAK,CAAC;CACd;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.4.0",
+	"version": "0.5.0",
 	"type": "module",
 	"main": "./dist/index.cjs",
 	"exports": {