@stll/ai-catalog 0.8.2 → 0.9.0

package/README.md

@@ -39,8 +39,10 @@ one refresh pull request for both snapshots.
 `gen:capabilities --refresh` rejects before fetching or writing: rates owns the
 shared upstream refresh, and capabilities reads those refreshed inputs.
 The snapshot covers text input/output, cache reads/writes, and context tiers.
-Audio pricing is deliberately excluded because Stella does not route audio
-model input; an unknown models.dev cost field fails generation.
+The text-model snapshot excludes audio rates; an unknown models.dev cost field
+fails generation. `@stll/ai-catalog/transcription` owns the separately curated
+transcription catalog, with dated public sources, rational duration rates, and
+explicit capability and regional-availability evidence.
 
 ## Install
 

package/dist/benchmarks.d.ts

@@ -1,5 +1,5 @@
-import { w as OfferedBYOKModelId } from "./index-COmyIxMN.js";
 import { ModelBenchmarkMeasurement } from "./benchmark-frontier.js";
+import { w as OfferedBYOKModelId } from "./index-COmyIxMN.js";
 //#region src/benchmark-sources.d.ts
 export declare const MODEL_BENCHMARK_NAME = "Text Arena";
 export declare const MODEL_BENCHMARK_LICENCE = "CC BY 4.0";

package/dist/transcription.d.ts

@@ -0,0 +1,374 @@
+//#region src/transcription.d.ts
+type TranscriptionDurationPrice = {
+  kind: "audio-second";
+  usdNumerator: number;
+  secondsDenominator: number;
+};
+type TranscriptionRegionalAvailability = {
+  status: "available";
+  price: TranscriptionDurationPrice;
+} | {
+  status: "unavailable" | "unknown";
+};
+type TranscriptionModelMetadata = {
+  displayName: string;
+  price: TranscriptionDurationPrice;
+  languageClaim: string;
+  /** Granularities supported by the cited evidence; word includes segments. */
+  timestamps: "none" | "segment" | "word";
+  vocabularyMechanism: "none" | "groq-prompt" | "azure-phrase-list" | "context-hint";
+  diarization: "supported" | "unconfirmed";
+  residency: Record<"eu" | "us", TranscriptionRegionalAvailability>;
+  source: {
+    url: string;
+    checkedAt: string;
+  };
+};
+export declare const TRANSCRIPTION_MODELS: {
+  readonly "openai/whisper-large-v3-turbo": {
+    readonly displayName: "Whisper Large V3 Turbo";
+    readonly price: {
+      readonly kind: "audio-second";
+      readonly usdNumerator: 3;
+      readonly secondsDenominator: 1000000;
+    };
+    readonly languageClaim: "99+ languages";
+    readonly timestamps: "none";
+    readonly vocabularyMechanism: "groq-prompt";
+    readonly diarization: "unconfirmed";
+    readonly residency: {
+      readonly eu: {
+        readonly status: "unavailable";
+      };
+      readonly us: {
+        readonly status: "unknown";
+      };
+    };
+    readonly source: {
+      readonly url: "https://openrouter.ai/openai/whisper-large-v3-turbo";
+      readonly checkedAt: "2026-10-29";
+    };
+  };
+  readonly "openai/whisper-large-v3": {
+    readonly displayName: "Whisper Large V3";
+    readonly price: {
+      readonly kind: "audio-second";
+      readonly usdNumerator: 8;
+      readonly secondsDenominator: 1000000;
+    };
+    readonly languageClaim: "99+ languages";
+    readonly timestamps: "word";
+    readonly vocabularyMechanism: "groq-prompt";
+    readonly diarization: "unconfirmed";
+    readonly residency: {
+      readonly eu: {
+        readonly status: "unavailable";
+      };
+      readonly us: {
+        readonly status: "unknown";
+      };
+    };
+    readonly source: {
+      readonly url: "https://openrouter.ai/openai/whisper-large-v3";
+      readonly checkedAt: "2026-10-29";
+    };
+  };
+  readonly "nvidia/parakeet-tdt-0.6b-v3": {
+    readonly displayName: "Parakeet TDT 0.6B v3";
+    readonly price: {
+      readonly kind: "audio-second";
+      readonly usdNumerator: 25;
+      readonly secondsDenominator: 1000000;
+    };
+    readonly languageClaim: "All official EU languages";
+    readonly timestamps: "segment";
+    readonly vocabularyMechanism: "none";
+    readonly diarization: "unconfirmed";
+    readonly residency: {
+      readonly eu: {
+        readonly status: "unavailable";
+      };
+      readonly us: {
+        readonly status: "unknown";
+      };
+    };
+    readonly source: {
+      readonly url: "https://openrouter.ai/nvidia/parakeet-tdt-0.6b-v3";
+      readonly checkedAt: "2026-10-29";
+    };
+  };
+  readonly "microsoft/mai-transcribe-2": {
+    readonly displayName: "MAI-Transcribe 2";
+    readonly price: {
+      readonly kind: "audio-second";
+      readonly usdNumerator: 1;
+      readonly secondsDenominator: 36000;
+    };
+    readonly languageClaim: "60 languages";
+    readonly timestamps: "word";
+    readonly vocabularyMechanism: "azure-phrase-list";
+    readonly diarization: "supported";
+    readonly residency: {
+      readonly eu: {
+        readonly status: "unavailable";
+      };
+      readonly us: {
+        readonly status: "unknown";
+      };
+    };
+    readonly source: {
+      readonly url: "https://openrouter.ai/microsoft/mai-transcribe-2";
+      readonly checkedAt: "2026-10-29";
+    };
+  };
+  readonly "elevenlabs/scribe-v2": {
+    readonly displayName: "Scribe v2";
+    readonly price: {
+      readonly kind: "audio-second";
+      readonly usdNumerator: 61;
+      readonly secondsDenominator: 1000000;
+    };
+    readonly languageClaim: "90+ languages";
+    readonly timestamps: "word";
+    readonly vocabularyMechanism: "none";
+    readonly diarization: "supported";
+    readonly residency: {
+      readonly eu: {
+        readonly status: "unavailable";
+      };
+      readonly us: {
+        readonly status: "unknown";
+      };
+    };
+    readonly source: {
+      readonly url: "https://openrouter.ai/elevenlabs/scribe-v2";
+      readonly checkedAt: "2026-10-29";
+    };
+  };
+  readonly "mistralai/voxtral-mini-transcribe": {
+    readonly displayName: "Voxtral Mini Transcribe";
+    readonly price: {
+      readonly kind: "audio-second";
+      readonly usdNumerator: 50;
+      readonly secondsDenominator: 1000000;
+    };
+    readonly languageClaim: "Not specified";
+    readonly timestamps: "none";
+    readonly vocabularyMechanism: "none";
+    readonly diarization: "unconfirmed";
+    readonly residency: {
+      readonly eu: {
+        readonly status: "available";
+        readonly price: {
+          readonly kind: "audio-second";
+          readonly usdNumerator: 55;
+          readonly secondsDenominator: 1000000;
+        };
+      };
+      readonly us: {
+        readonly status: "unknown";
+      };
+    };
+    readonly source: {
+      readonly url: "https://openrouter.ai/mistralai/voxtral-mini-transcribe";
+      readonly checkedAt: "2026-10-29";
+    };
+  };
+  readonly "openai/gpt-transcribe": {
+    readonly displayName: "GPT Transcribe";
+    readonly price: {
+      readonly kind: "audio-second";
+      readonly usdNumerator: 75;
+      readonly secondsDenominator: 1000000;
+    };
+    readonly languageClaim: "Multilingual; language count not specified";
+    readonly timestamps: "none";
+    readonly vocabularyMechanism: "context-hint";
+    readonly diarization: "unconfirmed";
+    readonly residency: {
+      readonly eu: {
+        readonly status: "unavailable";
+      };
+      readonly us: {
+        readonly status: "unknown";
+      };
+    };
+    readonly source: {
+      readonly url: "https://openrouter.ai/openai/gpt-transcribe";
+      readonly checkedAt: "2026-10-29";
+    };
+  };
+};
+export type TranscriptionModelId = keyof typeof TRANSCRIPTION_MODELS;
+export type TranscriptionModel = (typeof TRANSCRIPTION_MODELS)[TranscriptionModelId];
+export type TranscriptionVocabularyMechanism = TranscriptionModelMetadata["vocabularyMechanism"];
+export declare const isTranscriptionModelId: (modelId: string) => modelId is TranscriptionModelId;
+export declare const getTranscriptionModel: (modelId: string) => {
+  readonly displayName: "Whisper Large V3 Turbo";
+  readonly price: {
+    readonly kind: "audio-second";
+    readonly usdNumerator: 3;
+    readonly secondsDenominator: 1000000;
+  };
+  readonly languageClaim: "99+ languages";
+  readonly timestamps: "none";
+  readonly vocabularyMechanism: "groq-prompt";
+  readonly diarization: "unconfirmed";
+  readonly residency: {
+    readonly eu: {
+      readonly status: "unavailable";
+    };
+    readonly us: {
+      readonly status: "unknown";
+    };
+  };
+  readonly source: {
+    readonly url: "https://openrouter.ai/openai/whisper-large-v3-turbo";
+    readonly checkedAt: "2026-10-29";
+  };
+} | {
+  readonly displayName: "Whisper Large V3";
+  readonly price: {
+    readonly kind: "audio-second";
+    readonly usdNumerator: 8;
+    readonly secondsDenominator: 1000000;
+  };
+  readonly languageClaim: "99+ languages";
+  readonly timestamps: "word";
+  readonly vocabularyMechanism: "groq-prompt";
+  readonly diarization: "unconfirmed";
+  readonly residency: {
+    readonly eu: {
+      readonly status: "unavailable";
+    };
+    readonly us: {
+      readonly status: "unknown";
+    };
+  };
+  readonly source: {
+    readonly url: "https://openrouter.ai/openai/whisper-large-v3";
+    readonly checkedAt: "2026-10-29";
+  };
+} | {
+  readonly displayName: "Parakeet TDT 0.6B v3";
+  readonly price: {
+    readonly kind: "audio-second";
+    readonly usdNumerator: 25;
+    readonly secondsDenominator: 1000000;
+  };
+  readonly languageClaim: "All official EU languages";
+  readonly timestamps: "segment";
+  readonly vocabularyMechanism: "none";
+  readonly diarization: "unconfirmed";
+  readonly residency: {
+    readonly eu: {
+      readonly status: "unavailable";
+    };
+    readonly us: {
+      readonly status: "unknown";
+    };
+  };
+  readonly source: {
+    readonly url: "https://openrouter.ai/nvidia/parakeet-tdt-0.6b-v3";
+    readonly checkedAt: "2026-10-29";
+  };
+} | {
+  readonly displayName: "MAI-Transcribe 2";
+  readonly price: {
+    readonly kind: "audio-second";
+    readonly usdNumerator: 1;
+    readonly secondsDenominator: 36000;
+  };
+  readonly languageClaim: "60 languages";
+  readonly timestamps: "word";
+  readonly vocabularyMechanism: "azure-phrase-list";
+  readonly diarization: "supported";
+  readonly residency: {
+    readonly eu: {
+      readonly status: "unavailable";
+    };
+    readonly us: {
+      readonly status: "unknown";
+    };
+  };
+  readonly source: {
+    readonly url: "https://openrouter.ai/microsoft/mai-transcribe-2";
+    readonly checkedAt: "2026-10-29";
+  };
+} | {
+  readonly displayName: "Scribe v2";
+  readonly price: {
+    readonly kind: "audio-second";
+    readonly usdNumerator: 61;
+    readonly secondsDenominator: 1000000;
+  };
+  readonly languageClaim: "90+ languages";
+  readonly timestamps: "word";
+  readonly vocabularyMechanism: "none";
+  readonly diarization: "supported";
+  readonly residency: {
+    readonly eu: {
+      readonly status: "unavailable";
+    };
+    readonly us: {
+      readonly status: "unknown";
+    };
+  };
+  readonly source: {
+    readonly url: "https://openrouter.ai/elevenlabs/scribe-v2";
+    readonly checkedAt: "2026-10-29";
+  };
+} | {
+  readonly displayName: "Voxtral Mini Transcribe";
+  readonly price: {
+    readonly kind: "audio-second";
+    readonly usdNumerator: 50;
+    readonly secondsDenominator: 1000000;
+  };
+  readonly languageClaim: "Not specified";
+  readonly timestamps: "none";
+  readonly vocabularyMechanism: "none";
+  readonly diarization: "unconfirmed";
+  readonly residency: {
+    readonly eu: {
+      readonly status: "available";
+      readonly price: {
+        readonly kind: "audio-second";
+        readonly usdNumerator: 55;
+        readonly secondsDenominator: 1000000;
+      };
+    };
+    readonly us: {
+      readonly status: "unknown";
+    };
+  };
+  readonly source: {
+    readonly url: "https://openrouter.ai/mistralai/voxtral-mini-transcribe";
+    readonly checkedAt: "2026-10-29";
+  };
+} | {
+  readonly displayName: "GPT Transcribe";
+  readonly price: {
+    readonly kind: "audio-second";
+    readonly usdNumerator: 75;
+    readonly secondsDenominator: 1000000;
+  };
+  readonly languageClaim: "Multilingual; language count not specified";
+  readonly timestamps: "none";
+  readonly vocabularyMechanism: "context-hint";
+  readonly diarization: "unconfirmed";
+  readonly residency: {
+    readonly eu: {
+      readonly status: "unavailable";
+    };
+    readonly us: {
+      readonly status: "unknown";
+    };
+  };
+  readonly source: {
+    readonly url: "https://openrouter.ai/openai/gpt-transcribe";
+    readonly checkedAt: "2026-10-29";
+  };
+} | undefined;
+//#endregion
+export {};

package/dist/transcription.js

@@ -0,0 +1,154 @@
+//#region src/transcription.ts
+const TRANSCRIPTION_MODELS = {
+	"openai/whisper-large-v3-turbo": {
+		displayName: "Whisper Large V3 Turbo",
+		price: {
+			kind: "audio-second",
+			usdNumerator: 3,
+			secondsDenominator: 1e6
+		},
+		languageClaim: "99+ languages",
+		timestamps: "none",
+		vocabularyMechanism: "groq-prompt",
+		diarization: "unconfirmed",
+		residency: {
+			eu: { status: "unavailable" },
+			us: { status: "unknown" }
+		},
+		source: {
+			url: "https://openrouter.ai/openai/whisper-large-v3-turbo",
+			checkedAt: "2026-10-29"
+		}
+	},
+	"openai/whisper-large-v3": {
+		displayName: "Whisper Large V3",
+		price: {
+			kind: "audio-second",
+			usdNumerator: 8,
+			secondsDenominator: 1e6
+		},
+		languageClaim: "99+ languages",
+		timestamps: "word",
+		vocabularyMechanism: "groq-prompt",
+		diarization: "unconfirmed",
+		residency: {
+			eu: { status: "unavailable" },
+			us: { status: "unknown" }
+		},
+		source: {
+			url: "https://openrouter.ai/openai/whisper-large-v3",
+			checkedAt: "2026-10-29"
+		}
+	},
+	"nvidia/parakeet-tdt-0.6b-v3": {
+		displayName: "Parakeet TDT 0.6B v3",
+		price: {
+			kind: "audio-second",
+			usdNumerator: 25,
+			secondsDenominator: 1e6
+		},
+		languageClaim: "All official EU languages",
+		timestamps: "segment",
+		vocabularyMechanism: "none",
+		diarization: "unconfirmed",
+		residency: {
+			eu: { status: "unavailable" },
+			us: { status: "unknown" }
+		},
+		source: {
+			url: "https://openrouter.ai/nvidia/parakeet-tdt-0.6b-v3",
+			checkedAt: "2026-10-29"
+		}
+	},
+	"microsoft/mai-transcribe-2": {
+		displayName: "MAI-Transcribe 2",
+		price: {
+			kind: "audio-second",
+			usdNumerator: 1,
+			secondsDenominator: 36e3
+		},
+		languageClaim: "60 languages",
+		timestamps: "word",
+		vocabularyMechanism: "azure-phrase-list",
+		diarization: "supported",
+		residency: {
+			eu: { status: "unavailable" },
+			us: { status: "unknown" }
+		},
+		source: {
+			url: "https://openrouter.ai/microsoft/mai-transcribe-2",
+			checkedAt: "2026-10-29"
+		}
+	},
+	"elevenlabs/scribe-v2": {
+		displayName: "Scribe v2",
+		price: {
+			kind: "audio-second",
+			usdNumerator: 61,
+			secondsDenominator: 1e6
+		},
+		languageClaim: "90+ languages",
+		timestamps: "word",
+		vocabularyMechanism: "none",
+		diarization: "supported",
+		residency: {
+			eu: { status: "unavailable" },
+			us: { status: "unknown" }
+		},
+		source: {
+			url: "https://openrouter.ai/elevenlabs/scribe-v2",
+			checkedAt: "2026-10-29"
+		}
+	},
+	"mistralai/voxtral-mini-transcribe": {
+		displayName: "Voxtral Mini Transcribe",
+		price: {
+			kind: "audio-second",
+			usdNumerator: 50,
+			secondsDenominator: 1e6
+		},
+		languageClaim: "Not specified",
+		timestamps: "none",
+		vocabularyMechanism: "none",
+		diarization: "unconfirmed",
+		residency: {
+			eu: {
+				status: "available",
+				price: {
+					kind: "audio-second",
+					usdNumerator: 55,
+					secondsDenominator: 1e6
+				}
+			},
+			us: { status: "unknown" }
+		},
+		source: {
+			url: "https://openrouter.ai/mistralai/voxtral-mini-transcribe",
+			checkedAt: "2026-10-29"
+		}
+	},
+	"openai/gpt-transcribe": {
+		displayName: "GPT Transcribe",
+		price: {
+			kind: "audio-second",
+			usdNumerator: 75,
+			secondsDenominator: 1e6
+		},
+		languageClaim: "Multilingual; language count not specified",
+		timestamps: "none",
+		vocabularyMechanism: "context-hint",
+		diarization: "unconfirmed",
+		residency: {
+			eu: { status: "unavailable" },
+			us: { status: "unknown" }
+		},
+		source: {
+			url: "https://openrouter.ai/openai/gpt-transcribe",
+			checkedAt: "2026-10-29"
+		}
+	}
+};
+const isTranscriptionModelId = (modelId) => Object.hasOwn(TRANSCRIPTION_MODELS, modelId);
+const getTranscriptionModel = (modelId) => Object.hasOwn(TRANSCRIPTION_MODELS, modelId) && isTranscriptionModelId(modelId) ? TRANSCRIPTION_MODELS[modelId] : void 0;
+//#endregion
+export { TRANSCRIPTION_MODELS, getTranscriptionModel, isTranscriptionModelId };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@stll/ai-catalog",
-  "version": "0.8.2",
+  "version": "0.9.0",
   "description": "Provider-neutral AI model roles, capabilities, and curated model metadata.",
   "keywords": [
     "ai",
@@ -40,6 +40,10 @@
     "./model-defaults-ledger": {
       "types": "./dist/model-defaults-ledger.d.ts",
       "import": "./dist/model-defaults-ledger.js"
+    },
+    "./transcription": {
+      "types": "./dist/transcription.d.ts",
+      "import": "./dist/transcription.js"
     }
   },
   "publishConfig": {
@@ -75,7 +79,8 @@
     "@tanstack/ai-openrouter": "0.21.1",
     "bun-types": "1.4.4",
     "fast-check": "^4.10.2",
-    "tsdown": "0.23.0"
+    "tsdown": "0.23.1",
+    "tsrs": "0.18.0-ts7.1.0-dev.20260929"
   },
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts"