@brotu/ai 0.4.0 → 0.6.0

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,
@@ -989,6 +991,105 @@ var QWEN_CATALOG = [
   )
 ];
 
+// src/providers/topaz.models.ts
+var VIDEO_RES = ["720p", "1080p", "4k"];
+function video(id, name, kind, description) {
+  return [id, { name, vendorModel: id, surface: "video", kind, description }];
+}
+function image(id, name, vendorModel, imagePath, description) {
+  return [
+    id,
+    { name, vendorModel, surface: "image", imagePath, description }
+  ];
+}
+var ENTRIES = [
+  // Precision video upscale (Proteus family)
+  video("prob-4", "Proteus", "upscale", "Default video upscale. Preserves the source."),
+  video("pnat-1", "Proteus Natural", "upscale", "Softer Proteus. 2\xD7 only."),
+  video("rhea-1", "Rhea", "upscale", "High-fidelity 4\xD7 upscale for fine detail."),
+  video("thd-3", "Theia Fine Tune Detail", "upscale", "More aggressive detail."),
+  video("thf-4", "Theia Fine Tune Fidelity", "upscale", "Lighter touch, closer to the source."),
+  video("thm-2", "Themis 2", "upscale", "Motion deblur."),
+  video("aaa-9", "Artemis Aliasing / Moire", "upscale", "Aliasing and moire cleanup."),
+  video("ahq-12", "Artemis High Quality", "upscale", "Artemis for clean footage."),
+  video("amq-13", "Artemis Medium Quality", "upscale", "Artemis for typical compression."),
+  video("amqs-2", "Artemis Medium Halo", "upscale", "Medium halo reduction."),
+  video("alq-13", "Artemis Low Quality", "upscale", "Artemis for degraded sources."),
+  video("alqs-2", "Artemis Strong Halo", "upscale", "Strong halo reduction."),
+  video("iris-3", "Iris Medium Quality", "upscale", "Face recovery, medium quality."),
+  video("iris-2", "Iris Low Quality", "upscale", "Face recovery, low quality."),
+  video("dtv-4", "Dione TV", "upscale", "Deinterlace broadcast footage."),
+  video("ddv-3", "Dione DV", "upscale", "Deinterlace camcorder footage."),
+  video("dtvs-2", "Dione Robust", "upscale", "Deinterlace degraded interlaced sources."),
+  video("dtd-4", "Dione Dehalo", "upscale", "Deinterlace with halo cleanup."),
+  video("dtds-2", "Dione Robust Dehalo", "upscale", "Deinterlace, degraded, with halo cleanup."),
+  video("ghq-5", "Gaia High Quality", "upscale", "CGI and animation, high quality."),
+  video("gcg-5", "Gaia CG", "upscale", "General CGI and renders."),
+  video("nyx-3", "Nyx", "upscale", "Default video denoise."),
+  video("nxl-1", "Nyx XL", "upscale", "Heavy video denoise."),
+  video("nxhf-1", "Nyx High Fidelity", "upscale", "Light denoise, keep texture."),
+  video("nxf-1", "Nyx Fast", "upscale", "Fast video denoise."),
+  video("color-1", "Video Colorization", "upscale", "Black-and-white to color."),
+  // Generative / creative video
+  video("slp-2.6", "Starlight Precise 2.6", "upscale", "Generative upscale to 4K. Faces, texture, text."),
+  video("slhq-1", "Starlight HQ", "upscale", "Maximum quality generative enhance."),
+  video("slf-2", "Starlight Fast 2", "upscale", "Faster generative upscale."),
+  video("slm-1", "Starlight Mini", "upscale", "Archival and interlaced restoration."),
+  video("wonder-1", "Starlight Sharp", "upscale", "Local-first sharpening restore."),
+  video("ast-2", "Astra 2", "upscale", "Creative GenAI video upscale."),
+  // Frame interpolation — not upscalers
+  video("aion-1", "Aion", "interpolation", "Extreme slow motion on complex, high-res motion."),
+  video("apo-8", "Apollo", "interpolation", "Default slow-mo and frame-rate conversion."),
+  video("apf-2", "Apollo Fast", "interpolation", "Faster Apollo."),
+  video("chr-2", "Chronos", "interpolation", "Interpolation for harder motion."),
+  video("chf-3", "Chronos Fast", "interpolation", "Faster Chronos."),
+  // Image — Gigapixel / enhance
+  image("standard-v2", "Standard 2", "Standard V2", "/image/v1/enhance/async", "Default image upscale."),
+  image("high-fidelity-v2", "High Fidelity 2", "High Fidelity V2", "/image/v1/enhance/async", "Maximum source preservation."),
+  image("low-resolution-v2", "Low Resolution 2", "Low Resolution V2", "/image/v1/enhance/async", "Tiny or heavily compressed sources."),
+  image("cgi", "Art & CGI", "CGI", "/image/v1/enhance/async", "Illustrations, renders, game art."),
+  image("text-refine", "Text & Shapes", "Text Refine", "/image/v1/enhance/async", "Documents, screenshots, type."),
+  // Image — generative enhance
+  image("standard-max", "Standard Max", "Standard MAX", "/image/v1/enhance-gen/async", "Default generative image upscale."),
+  image("wonder", "Wonder", "Wonder", "/image/v1/enhance-gen/async", "One-click generative restore."),
+  image("wonder-3.5", "Wonder 3.5", "Wonder 3.5", "/image/v1/enhance-gen/async", "Highest-quality generative image upscale."),
+  image("redefine", "Redefine", "Redefine", "/image/v1/enhance-gen/async", "Prompt-guided generative enhance."),
+  image("recovery-v2", "Recover 3", "Recovery V2", "/image/v1/enhance-gen/async", "Heavily damaged sources."),
+  image("bloom-2", "Bloom 2", "Bloom 2", "/image/v1/enhance-gen/async", "Creative upscale for GenAI images."),
+  image("denoise-max", "Denoise Max", "Denoise Max", "/image/v1/denoise-gen/async", "Highest-quality image denoise.")
+];
+var TOPAZ_MODELS = Object.fromEntries(
+  ENTRIES.flatMap(([id, binding]) => {
+    const rows = [[id, binding]];
+    if (binding.surface === "image" && binding.vendorModel !== id) {
+      rows.push([binding.vendorModel, binding]);
+    }
+    return rows;
+  })
+);
+function nodeTypes(binding) {
+  if (binding.surface === "image") return ["image_upscale"];
+  return binding.kind === "interpolation" ? ["video_gen"] : ["video_upscale"];
+}
+var TOPAZ_CATALOG = ENTRIES.map(([id, binding]) => ({
+  id,
+  name: binding.name,
+  category: binding.surface,
+  inputType: binding.surface === "video" ? "video_required" : "image_required",
+  nodeTypes: nodeTypes(binding),
+  creditsPerUnit: 0,
+  creditUnit: binding.surface === "video" ? "second" : "image",
+  supportedResolutions: binding.surface === "video" ? [...VIDEO_RES] : void 0,
+  provider: "topaz",
+  description: binding.description
+}));
+var TOPAZ_VIDEO_MODELS = Object.fromEntries(
+  ENTRIES.filter(([, binding]) => binding.surface === "video")
+);
+var TOPAZ_IMAGE_MODELS = Object.fromEntries(
+  ENTRIES.filter(([, binding]) => binding.surface === "image")
+);
+
 // src/catalog.ts
 var PROVIDER_BASE_URLS = {
   byteplus: "https://ark.ap-southeast.bytepluses.com",
@@ -997,6 +1098,7 @@ var PROVIDER_BASE_URLS = {
   google: "https://generativelanguage.googleapis.com",
   openai: "https://api.openai.com",
   qwen: "https://dashscope-intl.aliyuncs.com",
+  topaz: "https://api.topazlabs.com",
   brotu: "https://api.brotu.app"
 };
 var DEFAULT_BROTU_API_URL = PROVIDER_BASE_URLS.brotu;
@@ -1014,7 +1116,8 @@ var BUILT_IN = [
   ...QWEN_CATALOG,
   ...OPENAI_CATALOG,
   ...GOOGLE_CATALOG,
-  ...ELEVENLABS_CATALOG
+  ...ELEVENLABS_CATALOG,
+  ...TOPAZ_CATALOG
 ];
 var catalog = BUILT_IN;
 var catalogMap = byId(BUILT_IN);
@@ -1084,18 +1187,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;AAW9E,OAAO,KAAK,EAAE,cAAc,EAAkB,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAiBhF,eAAO,MAAM,qBAAqB,QAA2B,CAAC;AAgC9D;;;;;;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-QQIHMDJC.js";
 export {
+  BROTU_SUPPORTED_CATEGORIES,
   DEFAULT_BROTU_API_URL,
+  describeModels,
   getAvailableModels,
   getModel,
   getModels,

package/dist/{chunk-QOWHHKSI.js → chunk-QQIHMDJC.js}

@@ -750,7 +750,7 @@ var imageOmni = {
       prompt: input.prompt
     };
     if (images.length > 0) {
-      body.image_list = images.map((image) => ({ image }));
+      body.image_list = images.map((image2) => ({ image: image2 }));
     }
     if (elements.length > 0) {
       body.element_list = elements.map((id) => ({ element_id: id }));
@@ -1152,6 +1152,105 @@ var QWEN_CATALOG = [
   )
 ];
 
+// src/providers/topaz.models.ts
+var VIDEO_RES = ["720p", "1080p", "4k"];
+function video(id, name, kind, description) {
+  return [id, { name, vendorModel: id, surface: "video", kind, description }];
+}
+function image(id, name, vendorModel, imagePath, description) {
+  return [
+    id,
+    { name, vendorModel, surface: "image", imagePath, description }
+  ];
+}
+var ENTRIES = [
+  // Precision video upscale (Proteus family)
+  video("prob-4", "Proteus", "upscale", "Default video upscale. Preserves the source."),
+  video("pnat-1", "Proteus Natural", "upscale", "Softer Proteus. 2\xD7 only."),
+  video("rhea-1", "Rhea", "upscale", "High-fidelity 4\xD7 upscale for fine detail."),
+  video("thd-3", "Theia Fine Tune Detail", "upscale", "More aggressive detail."),
+  video("thf-4", "Theia Fine Tune Fidelity", "upscale", "Lighter touch, closer to the source."),
+  video("thm-2", "Themis 2", "upscale", "Motion deblur."),
+  video("aaa-9", "Artemis Aliasing / Moire", "upscale", "Aliasing and moire cleanup."),
+  video("ahq-12", "Artemis High Quality", "upscale", "Artemis for clean footage."),
+  video("amq-13", "Artemis Medium Quality", "upscale", "Artemis for typical compression."),
+  video("amqs-2", "Artemis Medium Halo", "upscale", "Medium halo reduction."),
+  video("alq-13", "Artemis Low Quality", "upscale", "Artemis for degraded sources."),
+  video("alqs-2", "Artemis Strong Halo", "upscale", "Strong halo reduction."),
+  video("iris-3", "Iris Medium Quality", "upscale", "Face recovery, medium quality."),
+  video("iris-2", "Iris Low Quality", "upscale", "Face recovery, low quality."),
+  video("dtv-4", "Dione TV", "upscale", "Deinterlace broadcast footage."),
+  video("ddv-3", "Dione DV", "upscale", "Deinterlace camcorder footage."),
+  video("dtvs-2", "Dione Robust", "upscale", "Deinterlace degraded interlaced sources."),
+  video("dtd-4", "Dione Dehalo", "upscale", "Deinterlace with halo cleanup."),
+  video("dtds-2", "Dione Robust Dehalo", "upscale", "Deinterlace, degraded, with halo cleanup."),
+  video("ghq-5", "Gaia High Quality", "upscale", "CGI and animation, high quality."),
+  video("gcg-5", "Gaia CG", "upscale", "General CGI and renders."),
+  video("nyx-3", "Nyx", "upscale", "Default video denoise."),
+  video("nxl-1", "Nyx XL", "upscale", "Heavy video denoise."),
+  video("nxhf-1", "Nyx High Fidelity", "upscale", "Light denoise, keep texture."),
+  video("nxf-1", "Nyx Fast", "upscale", "Fast video denoise."),
+  video("color-1", "Video Colorization", "upscale", "Black-and-white to color."),
+  // Generative / creative video
+  video("slp-2.6", "Starlight Precise 2.6", "upscale", "Generative upscale to 4K. Faces, texture, text."),
+  video("slhq-1", "Starlight HQ", "upscale", "Maximum quality generative enhance."),
+  video("slf-2", "Starlight Fast 2", "upscale", "Faster generative upscale."),
+  video("slm-1", "Starlight Mini", "upscale", "Archival and interlaced restoration."),
+  video("wonder-1", "Starlight Sharp", "upscale", "Local-first sharpening restore."),
+  video("ast-2", "Astra 2", "upscale", "Creative GenAI video upscale."),
+  // Frame interpolation — not upscalers
+  video("aion-1", "Aion", "interpolation", "Extreme slow motion on complex, high-res motion."),
+  video("apo-8", "Apollo", "interpolation", "Default slow-mo and frame-rate conversion."),
+  video("apf-2", "Apollo Fast", "interpolation", "Faster Apollo."),
+  video("chr-2", "Chronos", "interpolation", "Interpolation for harder motion."),
+  video("chf-3", "Chronos Fast", "interpolation", "Faster Chronos."),
+  // Image — Gigapixel / enhance
+  image("standard-v2", "Standard 2", "Standard V2", "/image/v1/enhance/async", "Default image upscale."),
+  image("high-fidelity-v2", "High Fidelity 2", "High Fidelity V2", "/image/v1/enhance/async", "Maximum source preservation."),
+  image("low-resolution-v2", "Low Resolution 2", "Low Resolution V2", "/image/v1/enhance/async", "Tiny or heavily compressed sources."),
+  image("cgi", "Art & CGI", "CGI", "/image/v1/enhance/async", "Illustrations, renders, game art."),
+  image("text-refine", "Text & Shapes", "Text Refine", "/image/v1/enhance/async", "Documents, screenshots, type."),
+  // Image — generative enhance
+  image("standard-max", "Standard Max", "Standard MAX", "/image/v1/enhance-gen/async", "Default generative image upscale."),
+  image("wonder", "Wonder", "Wonder", "/image/v1/enhance-gen/async", "One-click generative restore."),
+  image("wonder-3.5", "Wonder 3.5", "Wonder 3.5", "/image/v1/enhance-gen/async", "Highest-quality generative image upscale."),
+  image("redefine", "Redefine", "Redefine", "/image/v1/enhance-gen/async", "Prompt-guided generative enhance."),
+  image("recovery-v2", "Recover 3", "Recovery V2", "/image/v1/enhance-gen/async", "Heavily damaged sources."),
+  image("bloom-2", "Bloom 2", "Bloom 2", "/image/v1/enhance-gen/async", "Creative upscale for GenAI images."),
+  image("denoise-max", "Denoise Max", "Denoise Max", "/image/v1/denoise-gen/async", "Highest-quality image denoise.")
+];
+var TOPAZ_MODELS = Object.fromEntries(
+  ENTRIES.flatMap(([id, binding]) => {
+    const rows = [[id, binding]];
+    if (binding.surface === "image" && binding.vendorModel !== id) {
+      rows.push([binding.vendorModel, binding]);
+    }
+    return rows;
+  })
+);
+function nodeTypes(binding) {
+  if (binding.surface === "image") return ["image_upscale"];
+  return binding.kind === "interpolation" ? ["video_gen"] : ["video_upscale"];
+}
+var TOPAZ_CATALOG = ENTRIES.map(([id, binding]) => ({
+  id,
+  name: binding.name,
+  category: binding.surface,
+  inputType: binding.surface === "video" ? "video_required" : "image_required",
+  nodeTypes: nodeTypes(binding),
+  creditsPerUnit: 0,
+  creditUnit: binding.surface === "video" ? "second" : "image",
+  supportedResolutions: binding.surface === "video" ? [...VIDEO_RES] : void 0,
+  provider: "topaz",
+  description: binding.description
+}));
+var TOPAZ_VIDEO_MODELS = Object.fromEntries(
+  ENTRIES.filter(([, binding]) => binding.surface === "video")
+);
+var TOPAZ_IMAGE_MODELS = Object.fromEntries(
+  ENTRIES.filter(([, binding]) => binding.surface === "image")
+);
+
 // src/catalog.ts
 var PROVIDER_BASE_URLS = {
   byteplus: "https://ark.ap-southeast.bytepluses.com",
@@ -1160,6 +1259,7 @@ var PROVIDER_BASE_URLS = {
   google: "https://generativelanguage.googleapis.com",
   openai: "https://api.openai.com",
   qwen: "https://dashscope-intl.aliyuncs.com",
+  topaz: "https://api.topazlabs.com",
   brotu: "https://api.brotu.app"
 };
 var DEFAULT_BROTU_API_URL = PROVIDER_BASE_URLS.brotu;
@@ -1177,7 +1277,8 @@ var BUILT_IN = [
   ...QWEN_CATALOG,
   ...OPENAI_CATALOG,
   ...GOOGLE_CATALOG,
-  ...ELEVENLABS_CATALOG
+  ...ELEVENLABS_CATALOG,
+  ...TOPAZ_CATALOG
 ];
 var catalog = BUILT_IN;
 var catalogMap = byId(BUILT_IN);
@@ -1247,14 +1348,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 {
@@ -1286,6 +1417,10 @@ export {
   QWEN_AUDIO_MODELS,
   QWEN_TEXT_MODELS,
   QWEN_CATALOG,
+  TOPAZ_MODELS,
+  TOPAZ_CATALOG,
+  TOPAZ_VIDEO_MODELS,
+  TOPAZ_IMAGE_MODELS,
   DEFAULT_BROTU_API_URL,
   registerModels,
   resetCatalog,
@@ -1294,5 +1429,7 @@ export {
   hasModel,
   getProviders,
   resolveProvider,
+  BROTU_SUPPORTED_CATEGORIES,
+  describeModels,
   getAvailableModels
 };

package/dist/client.d.ts

@@ -1,32 +1,53 @@
-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";
 import { type WebhookConfig } from "./lib/webhook";
-import type { AudioGenerationParams, CostEstimate, GenerationOutput, GenerationParams, GenerationType, ImageGenerationParams, TextGenerationParams, VideoGenerationParams } from "./ports/content-generator.port";
+import type { AudioGenerationParams, CostEstimate, GenerationOutput, GenerationParams, GenerationType, ImageGenerationParams, ImageUpscaleParams, TextGenerationParams, VideoGenerationParams, VideoUpscaleParams } 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";
 /** Providers this package ships an adapter for. */
-export declare const NATIVE_PROVIDERS: readonly ["byteplus", "elevenlabs", "google", "kling", "openai", "qwen"];
+export declare const NATIVE_PROVIDERS: readonly ["byteplus", "elevenlabs", "google", "kling", "openai", "qwen", "topaz"];
 export interface BrotuAI {
     image: {
         /** Queue the work and return a handle. Only the submit is awaited. */
         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[];
+        /**
+         * Enhance a still you already have. `imageUrl` is required; `prompt` is
+         * optional. Waits for the result — image upscale is usually seconds.
+         */
+        upscale(params: ImageUpscaleParams): Promise<Result<Generation>>;
     };
     video: {
         submit(params: VideoGenerationParams): Promise<Result<Job>>;
         generate(params: VideoGenerationParams): Promise<Result<Generation>>;
+        list(): ModelAvailability[];
+        /**
+         * Enhance a video you already have. `videoUrl` is required; `prompt` is
+         * optional. Returns a handle — video upscale takes minutes.
+         */
+        upscale(params: VideoUpscaleParams): Promise<Result<Job>>;
     };
     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 +111,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":"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"}
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"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"}