mewkit 1.16.1 → 1.17.0

package/dist/migrate/model-taxonomy.d.ts

@@ -7,10 +7,42 @@ export interface ModelResolveResult {
     resolved: ResolvedModel | null;
     warning?: string;
 }
+/**
+ * A NAMED model profile — resolved before tier mapping and deliberately
+ * ORTHOGONAL to `ModelTier`.
+ *
+ * Why not a tier: a tier answers "how much capability does this task need",
+ * and every consumer maps the closed `ModelTier` union exhaustively
+ * (`Record<ModelTier, …>` in model-routing-config.ts). Growing that union to
+ * express "this specific model" would compile-break every such map and conflate
+ * two different questions. A profile answers "this named model specifically" —
+ * so it resolves first and leaves the tier ladder untouched.
+ *
+ * Why not `if (model === "fable")` next to resolveModel: a one-off branch is a
+ * parallel schema that the next named profile has to copy. A table means the
+ * second profile is a row, not a rewrite.
+ */
+export interface ModelProfile {
+    /** The verified runtime identifier on providers that support it. */
+    identifier: string;
+    /** Providers that resolve this profile natively. Everything else falls back. */
+    supportedProviders: readonly string[];
+    /** Tier used for the DISCLOSED fallback on unsupported providers. */
+    fallbackTier: ModelTier;
+    /** How `identifier` was verified — so a rename is traceable, not archaeology. */
+    evidence: string;
+}
 export declare function setTaxonomyOverrides(overrides: Record<string, Record<string, ResolvedModel>> | undefined): void;
 export declare function resolveOpenCodeDefaultModel(): string | undefined;
 export declare function getOpenCodeDefaultModelOverride(): string | undefined;
 export declare function resolveModel(sourceModel: string | undefined, targetProvider: string): ModelResolveResult;
+/** Every named profile, for diagnostics and tests. Read-only view of the table. */
+export declare function listModelProfiles(): ReadonlyArray<{
+    name: string;
+    profile: ModelProfile;
+}>;
+/** True when `targetProvider` resolves `name` natively (vs. taking a disclosed fallback). */
+export declare function providerSupportsProfile(name: string, targetProvider: string): boolean;
 export declare function resolveProviderDefaultModel(targetProvider: string): ResolvedModel | null;
 export declare function rewriteConfiguredModelReferences(content: string, targetProvider: string): string;
 //# sourceMappingURL=model-taxonomy.d.ts.map

package/dist/migrate/model-taxonomy.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"model-taxonomy.d.ts","sourceRoot":"","sources":["../../src/migrate/model-taxonomy.ts"],"names":[],"mappings":"AAGA,MAAM,MAAM,SAAS,GAAG,OAAO,GAAG,UAAU,GAAG,OAAO,CAAC;AAEvD,MAAM,WAAW,aAAa;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,kBAAkB;IAClC,QAAQ,EAAE,aAAa,GAAG,IAAI,CAAC;IAC/B,OAAO,CAAC,EAAE,MAAM,CAAC;CACjB;AAUD,wBAAgB,oBAAoB,CAAC,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC,GAAG,SAAS,GAAG,IAAI,CAE/G;AAED,wBAAgB,2BAA2B,IAAI,MAAM,GAAG,SAAS,CAEhE;AAED,wBAAgB,+BAA+B,IAAI,MAAM,GAAG,SAAS,CAEpE;AAED,wBAAgB,YAAY,CAAC,WAAW,EAAE,MAAM,GAAG,SAAS,EAAE,cAAc,EAAE,MAAM,GAAG,kBAAkB,CA2BxG;AAED,wBAAgB,2BAA2B,CAAC,cAAc,EAAE,MAAM,GAAG,aAAa,GAAG,IAAI,CAExF;AAED,wBAAgB,gCAAgC,CAAC,OAAO,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,GAAG,MAAM,CAKhG"}
+{"version":3,"file":"model-taxonomy.d.ts","sourceRoot":"","sources":["../../src/migrate/model-taxonomy.ts"],"names":[],"mappings":"AAGA,MAAM,MAAM,SAAS,GAAG,OAAO,GAAG,UAAU,GAAG,OAAO,CAAC;AAEvD,MAAM,WAAW,aAAa;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,kBAAkB;IAClC,QAAQ,EAAE,aAAa,GAAG,IAAI,CAAC;IAC/B,OAAO,CAAC,EAAE,MAAM,CAAC;CACjB;AAQD;;;;;;;;;;;;;;GAcG;AACH,MAAM,WAAW,YAAY;IAC5B,oEAAoE;IACpE,UAAU,EAAE,MAAM,CAAC;IACnB,gFAAgF;IAChF,kBAAkB,EAAE,SAAS,MAAM,EAAE,CAAC;IACtC,qEAAqE;IACrE,YAAY,EAAE,SAAS,CAAC;IACxB,iFAAiF;IACjF,QAAQ,EAAE,MAAM,CAAC;CACjB;AAwDD,wBAAgB,oBAAoB,CAAC,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC,GAAG,SAAS,GAAG,IAAI,CAE/G;AAED,wBAAgB,2BAA2B,IAAI,MAAM,GAAG,SAAS,CAEhE;AAED,wBAAgB,+BAA+B,IAAI,MAAM,GAAG,SAAS,CAEpE;AAED,wBAAgB,YAAY,CAAC,WAAW,EAAE,MAAM,GAAG,SAAS,EAAE,cAAc,EAAE,MAAM,GAAG,kBAAkB,CAiCxG;AAED,mFAAmF;AACnF,wBAAgB,iBAAiB,IAAI,aAAa,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,YAAY,CAAA;CAAE,CAAC,CAE1F;AAED,6FAA6F;AAC7F,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,GAAG,OAAO,CAErF;AAED,wBAAgB,2BAA2B,CAAC,cAAc,EAAE,MAAM,GAAG,aAAa,GAAG,IAAI,CAExF;AAED,wBAAgB,gCAAgC,CAAC,OAAO,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,GAAG,MAAM,CAKhG"}

package/dist/migrate/model-taxonomy.js

@@ -5,6 +5,51 @@ const SOURCE_TIER_MAP = {
     sonnet: "balanced",
     haiku: "light",
 };
+/**
+ * Named profiles, keyed by the string that appears in frontmatter (`model: fable`).
+ *
+ * The identifier lives in exactly one place: a model rename is a one-line edit
+ * here, not a grep across converters.
+ */
+const NAMED_PROFILES = {
+    fable: {
+        identifier: "claude-fable-5",
+        // Claude Code resolves Claude model ids natively. Every other target in
+        // ProviderType is a different vendor's host: asserting they can run a
+        // Claude model would be an over-claim, so they take the disclosed fallback.
+        supportedProviders: ["claude-code"],
+        fallbackTier: "heavy",
+        evidence: "claude-api skill model table (cached 2026-06-24) + its shared/models.md — exact id, no date suffix",
+    },
+};
+/**
+ * Resolve a named profile for a target provider.
+ *
+ * Two honest outcomes, never a third: the provider supports the profile and gets
+ * the verified identifier, or it does not and gets a fallback that SAYS SO.
+ * Silently substituting a different model would mean a skill that asked for a
+ * specific model quietly ran on another one.
+ */
+function resolveNamedProfile(name, profile, targetProvider) {
+    if (profile.supportedProviders.includes(targetProvider)) {
+        return { resolved: { model: profile.identifier } };
+    }
+    const fallback = userOverrides?.[targetProvider]?.[profile.fallbackTier];
+    if (fallback) {
+        return {
+            resolved: fallback,
+            warning: `Model profile "${name}" (${profile.identifier}) is not available on ${targetProvider} — ` +
+                `falling back to the configured "${profile.fallbackTier}" model "${fallback.model}". ` +
+                `This is a substitution, not an equivalent.`,
+        };
+    }
+    return {
+        resolved: null,
+        warning: `Model profile "${name}" (${profile.identifier}) is not available on ${targetProvider}, ` +
+            `and no "${profile.fallbackTier}" model is configured for it — the target will inherit its default. ` +
+            `To pin one, set modelRouting.providers.${targetProvider}.tiers.${profile.fallbackTier} in .meowkit.config.json.`,
+    };
+}
 let userOverrides;
 export function setTaxonomyOverrides(overrides) {
     userOverrides = overrides;
@@ -27,6 +72,12 @@ export function resolveModel(sourceModel, targetProvider) {
     const trimmed = sourceModel.trim();
     if (!trimmed || trimmed === "inherit")
         return { resolved: null };
+    // Named profiles resolve BEFORE tier mapping: they name a specific model, which
+    // the tier ladder cannot express. Keeping this ahead of SOURCE_TIER_MAP is what
+    // makes the profile tier-orthogonal rather than a fourth tier.
+    const profile = NAMED_PROFILES[trimmed];
+    if (profile)
+        return resolveNamedProfile(trimmed, profile, targetProvider);
     const tier = SOURCE_TIER_MAP[trimmed];
     if (!tier) {
         return { resolved: null, warning: `Unknown model "${trimmed}" — not in taxonomy, commented out` };
@@ -42,6 +93,14 @@ export function resolveModel(sourceModel, targetProvider) {
         warning: `No configured ${targetProvider} model for source tier "${trimmed}" — target will inherit its default`,
     };
 }
+/** Every named profile, for diagnostics and tests. Read-only view of the table. */
+export function listModelProfiles() {
+    return Object.entries(NAMED_PROFILES).map(([name, profile]) => ({ name, profile }));
+}
+/** True when `targetProvider` resolves `name` natively (vs. taking a disclosed fallback). */
+export function providerSupportsProfile(name, targetProvider) {
+    return NAMED_PROFILES[name]?.supportedProviders.includes(targetProvider) ?? false;
+}
 export function resolveProviderDefaultModel(targetProvider) {
     return userOverrides?.[targetProvider]?.default ?? null;
 }

package/dist/migrate/model-taxonomy.js.map

@@ -1 +1 @@
-{"version":3,"file":"model-taxonomy.js","sourceRoot":"","sources":["../../src/migrate/model-taxonomy.ts"],"names":[],"mappings":"AAAA,qFAAqF;AACrF,4FAA4F;AAc5F,MAAM,eAAe,GAA8B;IAClD,IAAI,EAAE,OAAO;IACb,MAAM,EAAE,UAAU;IAClB,KAAK,EAAE,OAAO;CACd,CAAC;AAEF,IAAI,aAAwE,CAAC;AAE7E,MAAM,UAAU,oBAAoB,CAAC,SAAoE;IACxG,aAAa,GAAG,SAAS,CAAC;AAC3B,CAAC;AAED,MAAM,UAAU,2BAA2B;IAC1C,OAAO,aAAa,EAAE,QAAQ,EAAE,OAAO,EAAE,KAAK,CAAC;AAChD,CAAC;AAED,MAAM,UAAU,+BAA+B;IAC9C,OAAO,aAAa,EAAE,QAAQ,EAAE,OAAO,EAAE,KAAK,CAAC;AAChD,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,WAA+B,EAAE,cAAsB;IACnF,IAAI,WAAW,KAAK,SAAS,IAAI,WAAW,KAAK,IAAI;QAAE,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;IACjF,IAAI,OAAO,WAAW,KAAK,QAAQ,EAAE,CAAC;QACrC,OAAO;YACN,QAAQ,EAAE,IAAI;YACd,OAAO,EAAE,yCAAyC,OAAO,WAAW,GAAG;SACvE,CAAC;IACH,CAAC;IAED,MAAM,OAAO,GAAG,WAAW,CAAC,IAAI,EAAE,CAAC;IACnC,IAAI,CAAC,OAAO,IAAI,OAAO,KAAK,SAAS;QAAE,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;IAEjE,MAAM,IAAI,GAAG,eAAe,CAAC,OAAO,CAAC,CAAC;IACtC,IAAI,CAAC,IAAI,EAAE,CAAC;QACX,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,OAAO,EAAE,kBAAkB,OAAO,oCAAoC,EAAE,CAAC;IACnG,CAAC;IAED,MAAM,WAAW,GAAG,aAAa,EAAE,CAAC,cAAc,CAAC,CAAC;IACpD,IAAI,WAAW,EAAE,CAAC;QACjB,MAAM,QAAQ,GAAG,WAAW,CAAC,IAAI,CAAC,CAAC;QACnC,IAAI,QAAQ;YAAE,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,CAAC;IAC7C,CAAC;IAED,OAAO;QACN,QAAQ,EAAE,IAAI;QACd,OAAO,EAAE,iBAAiB,cAAc,2BAA2B,OAAO,qCAAqC;KAC/G,CAAC;AACH,CAAC;AAED,MAAM,UAAU,2BAA2B,CAAC,cAAsB;IACjE,OAAO,aAAa,EAAE,CAAC,cAAc,CAAC,EAAE,OAAO,IAAI,IAAI,CAAC;AACzD,CAAC;AAED,MAAM,UAAU,gCAAgC,CAAC,OAAe,EAAE,cAAsB;IACvF,OAAO,OAAO,CAAC,OAAO,CAAC,qCAAqC,EAAE,CAAC,OAAO,EAAE,MAAc,EAAE,QAAgB,EAAE,EAAE;QAC3G,MAAM,QAAQ,GAAG,YAAY,CAAC,QAAQ,CAAC,WAAW,EAAE,EAAE,cAAc,CAAC,CAAC,QAAQ,CAAC;QAC/E,OAAO,QAAQ,EAAE,KAAK,CAAC,CAAC,CAAC,GAAG,MAAM,GAAG,QAAQ,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC;IACjE,CAAC,CAAC,CAAC;AACJ,CAAC"}
+{"version":3,"file":"model-taxonomy.js","sourceRoot":"","sources":["../../src/migrate/model-taxonomy.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mewkit",
-  "version": "1.16.1",
+  "version": "1.17.0",
   "description": "MeowKit CLI — scaffold, upgrade, and manage your AI agent toolkit",
   "type": "module",
   "bin": {
@@ -59,4 +59,4 @@
     "node": ">=20"
   },
   "license": "MIT"
-}
+}