@molecule/app-ide-react 1.0.0

package/dist/components/chat-model-mode-utilities.d.ts

@@ -0,0 +1,143 @@
+/**
+ * Pure helpers backing the per-mode model pickers (`/model --plan`,
+ * `/model --execute`, `/model --commit`, and `/model --compact`).
+ *
+ * A project stores optional per-mode model ids in its settings — `planModel`
+ * (used in plan mode) and `executeModel` (used in execute mode) alongside the
+ * legacy single `chatModel`, plus two auxiliary jobs: `commitModel` (the
+ * commit-message generator) and `compactModel` (conversation compaction), which
+ * fall back to the server's own fast default (never `chatModel`) when unset.
+ * These helpers parse the mode flag, map a mode to its settings field, resolve
+ * the effective model for a mode, and compute the free-tier clamp (plan →
+ * `deepseek-v4-pro`, execute → `deepseek-v4-flash`, commit/compact → any
+ * free-tier-flagged model) against the live catalog. The clamp ids mirror the
+ * server's FREE_TIER_MODELS in molecule-dev's `model-selection.ts` — keep the
+ * two in sync (a stale Sonnet-plan assumption here once highlighted the wrong
+ * "current" model in the picker).
+ *
+ * Everything here is deterministic and side-effect free so it can be unit tested
+ * without rendering or a backend. The component owns persistence (`PATCH
+ * /projects/:id { settings }`) and any `t()` prose.
+ *
+ * @module
+ */
+import type { AppModelDefinition } from '@molecule/app-ai-models';
+/** A conversation mode or auxiliary job that can have its own model. */
+export type ModelMode = 'plan' | 'execute' | 'commit' | 'compact';
+/** The subset of project settings this module reads for model resolution. */
+export interface PerModeModelSettings {
+    /** Model id used in plan mode (falls back to {@link PerModeModelSettings.chatModel}). */
+    planModel?: string;
+    /** Model id used in execute mode (falls back to {@link PerModeModelSettings.chatModel}). */
+    executeModel?: string;
+    /** Model id for commit-message generation (server's fast default when unset). */
+    commitModel?: string;
+    /** Model id for conversation compaction (server's fast default when unset). */
+    compactModel?: string;
+    /** Legacy single model id, used when the plan/execute field is unset. */
+    chatModel?: string;
+}
+/**
+ * Parses a `/model --plan`, `--execute`, `--commit`, or `--compact` command.
+ * Returns the targeted mode plus any trailing filter `query` (the text after
+ * the flag), or `null` when the input is not a mode-scoped `/model` command.
+ * Use this *before* the generic `/model <name>` handler so the flag is not
+ * mistaken for a model name.
+ *
+ * @param input - The raw chat input.
+ * @returns `{ mode, query }` for a mode-scoped command, else `null`.
+ */
+export declare function parseModelModeCommand(input: string): {
+    mode: ModelMode;
+    query: string;
+} | null;
+/**
+ * Maps a mode to the project-settings field that stores its model id.
+ *
+ * @param mode - The conversation mode or auxiliary job.
+ * @returns The settings field for the mode (e.g. `'planModel'` for plan mode).
+ */
+export declare function modeSettingKey(mode: ModelMode): 'planModel' | 'executeModel' | 'commitModel' | 'compactModel';
+/**
+ * Resolves the effective model id for a mode. The conversation modes
+ * (plan/execute) fall back to the legacy single `chatModel` when the per-mode
+ * field is unset (back-compat); the auxiliary jobs (commit/compact) do NOT —
+ * the server applies its own fast default for them, mirrored here by returning
+ * `undefined`.
+ *
+ * @param settings - The project's model settings.
+ * @param mode - The conversation mode or auxiliary job.
+ * @returns The resolved model id, or `undefined` when nothing is configured.
+ */
+export declare function resolveModeModel(settings: PerModeModelSettings, mode: ModelMode): string | undefined;
+/**
+ * Computes the free-tier-allowed model id for a mode from the live catalog. The
+ * free/anon tier is clamped — with no mixing — to `deepseek-v4-pro` in plan
+ * mode and `deepseek-v4-flash` in execute mode (the auxiliary commit/compact
+ * jobs share the execute clamp), mirroring the server's FREE_TIER_MODELS.
+ * Matching is catalog-driven (by id/provider) so it survives id churn; when no
+ * specific match exists it falls back to the supplied `fallback` (the
+ * catalog's free-tier model id).
+ *
+ * @param models - The available models from the catalog.
+ * @param mode - The conversation mode or auxiliary job.
+ * @param fallback - The free-tier model id to use when no match is found.
+ * @returns The clamped model id for the mode.
+ */
+export declare function freeTierModeModelId(models: readonly AppModelDefinition[], mode: ModelMode, fallback: string): string;
+/**
+ * Why a model is locked for a free-tier user in a given mode — `'paid'` for a
+ * genuinely paid model, `'mode'` for a model the free tier CAN use, just in a
+ * different mode (e.g. the execute clamp shown in the plan-scoped picker).
+ */
+export type FreeTierLockReason = 'paid' | 'mode';
+/**
+ * The lock reason for a model in a mode under the free-tier clamp, or `null`
+ * when it is selectable. Pro users and `provider: 'custom'` (bring-your-own
+ * AI) models are never locked; a free/anon user may pick only the mode's
+ * clamped model (plan/execute) or any free-tier-flagged model (the auxiliary
+ * commit/compact jobs, mirroring the server's aux-model selection, which
+ * ignores a non-free platform pick anyway).
+ *
+ * A locked model splits into two very different cases the UI must not
+ * conflate: `'paid'` (upgrade actually unlocks it) versus `'mode'` (the model
+ * is free-tier-usable in ANOTHER mode — it is a different mode's clamp, or
+ * free-tier-flagged and thus selectable for commit/compact — so a "Pro" badge
+ * would be flatly wrong).
+ *
+ * @param modelId - The candidate model id.
+ * @param mode - The conversation mode the picker is scoped to.
+ * @param isFreeTier - Whether the current user is on the free/anon tier.
+ * @param models - The available models from the catalog.
+ * @param fallback - The free-tier model id to use when no clamp match is found.
+ * @returns `'paid'` / `'mode'` when locked, `null` when selectable.
+ */
+export declare function freeTierLockReason(modelId: string, mode: ModelMode, isFreeTier: boolean, models: readonly AppModelDefinition[], fallback: string): FreeTierLockReason | null;
+/**
+ * The mode a free-tier user can actually use this model in — `'plan'` /
+ * `'execute'` when it is that mode's clamp, `'commit'` (standing for both
+ * auxiliary jobs) when it is merely free-tier-flagged, `null` when the free
+ * tier can't use it anywhere. Drives the "free in <mode>" labeling next to a
+ * `'mode'`-locked row.
+ *
+ * @param modelId - The candidate model id.
+ * @param models - The available models from the catalog.
+ * @param fallback - The free-tier model id to use when no clamp match is found.
+ * @returns The mode the model is free-tier-usable in, or `null`.
+ */
+export declare function freeTierUsableMode(modelId: string, models: readonly AppModelDefinition[], fallback: string): ModelMode | null;
+/**
+ * Whether a model is locked (not selectable) for the given mode under the
+ * free-tier clamp — the boolean view of {@link freeTierLockReason} (which see
+ * for the rules: pro users and custom models never lock; plan/execute clamp to
+ * one model; commit/compact accept any free-tier-flagged model).
+ *
+ * @param modelId - The candidate model id.
+ * @param mode - The conversation mode the picker is scoped to.
+ * @param isFreeTier - Whether the current user is on the free/anon tier.
+ * @param models - The available models from the catalog.
+ * @param fallback - The free-tier model id to use when no clamp match is found.
+ * @returns `true` when the model is locked for this user and mode.
+ */
+export declare function isModeModelLocked(modelId: string, mode: ModelMode, isFreeTier: boolean, models: readonly AppModelDefinition[], fallback: string): boolean;
+//# sourceMappingURL=chat-model-mode-utilities.d.ts.map

package/dist/components/chat-model-mode-utilities.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chat-model-mode-utilities.d.ts","sourceRoot":"","sources":["../../src/components/chat-model-mode-utilities.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAA;AAEjE,wEAAwE;AACxE,MAAM,MAAM,SAAS,GAAG,MAAM,GAAG,SAAS,GAAG,QAAQ,GAAG,SAAS,CAAA;AAEjE,6EAA6E;AAC7E,MAAM,WAAW,oBAAoB;IACnC,yFAAyF;IACzF,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,4FAA4F;IAC5F,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,iFAAiF;IACjF,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,+EAA+E;IAC/E,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,yEAAyE;IACzE,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAED;;;;;;;;;GASG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,MAAM,GAAG;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAI9F;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAC5B,IAAI,EAAE,SAAS,GACd,WAAW,GAAG,cAAc,GAAG,aAAa,GAAG,cAAc,CAW/D;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,gBAAgB,CAC9B,QAAQ,EAAE,oBAAoB,EAC9B,IAAI,EAAE,SAAS,GACd,MAAM,GAAG,SAAS,CAWpB;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,SAAS,kBAAkB,EAAE,EACrC,IAAI,EAAE,SAAS,EACf,QAAQ,EAAE,MAAM,GACf,MAAM,CAgBR;AAED;;;;GAIG;AACH,MAAM,MAAM,kBAAkB,GAAG,MAAM,GAAG,MAAM,CAAA;AAKhD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,SAAS,EACf,UAAU,EAAE,OAAO,EACnB,MAAM,EAAE,SAAS,kBAAkB,EAAE,EACrC,QAAQ,EAAE,MAAM,GACf,kBAAkB,GAAG,IAAI,CAe3B;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,SAAS,kBAAkB,EAAE,EACrC,QAAQ,EAAE,MAAM,GACf,SAAS,GAAG,IAAI,CAKlB;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,SAAS,EACf,UAAU,EAAE,OAAO,EACnB,MAAM,EAAE,SAAS,kBAAkB,EAAE,EACrC,QAAQ,EAAE,MAAM,GACf,OAAO,CAET"}

package/dist/components/chat-model-mode-utilities.js

@@ -0,0 +1,191 @@
+/**
+ * Pure helpers backing the per-mode model pickers (`/model --plan`,
+ * `/model --execute`, `/model --commit`, and `/model --compact`).
+ *
+ * A project stores optional per-mode model ids in its settings — `planModel`
+ * (used in plan mode) and `executeModel` (used in execute mode) alongside the
+ * legacy single `chatModel`, plus two auxiliary jobs: `commitModel` (the
+ * commit-message generator) and `compactModel` (conversation compaction), which
+ * fall back to the server's own fast default (never `chatModel`) when unset.
+ * These helpers parse the mode flag, map a mode to its settings field, resolve
+ * the effective model for a mode, and compute the free-tier clamp (plan →
+ * `deepseek-v4-pro`, execute → `deepseek-v4-flash`, commit/compact → any
+ * free-tier-flagged model) against the live catalog. The clamp ids mirror the
+ * server's FREE_TIER_MODELS in molecule-dev's `model-selection.ts` — keep the
+ * two in sync (a stale Sonnet-plan assumption here once highlighted the wrong
+ * "current" model in the picker).
+ *
+ * Everything here is deterministic and side-effect free so it can be unit tested
+ * without rendering or a backend. The component owns persistence (`PATCH
+ * /projects/:id { settings }`) and any `t()` prose.
+ *
+ * @module
+ */
+/**
+ * Parses a `/model --plan`, `--execute`, `--commit`, or `--compact` command.
+ * Returns the targeted mode plus any trailing filter `query` (the text after
+ * the flag), or `null` when the input is not a mode-scoped `/model` command.
+ * Use this *before* the generic `/model <name>` handler so the flag is not
+ * mistaken for a model name.
+ *
+ * @param input - The raw chat input.
+ * @returns `{ mode, query }` for a mode-scoped command, else `null`.
+ */
+export function parseModelModeCommand(input) {
+    const match = input.trim().match(/^\/model\s+--(plan|execute|commit|compact)\b\s*(.*)$/i);
+    if (!match)
+        return null;
+    return { mode: match[1].toLowerCase(), query: match[2].trim() };
+}
+/**
+ * Maps a mode to the project-settings field that stores its model id.
+ *
+ * @param mode - The conversation mode or auxiliary job.
+ * @returns The settings field for the mode (e.g. `'planModel'` for plan mode).
+ */
+export function modeSettingKey(mode) {
+    switch (mode) {
+        case 'plan':
+            return 'planModel';
+        case 'execute':
+            return 'executeModel';
+        case 'commit':
+            return 'commitModel';
+        case 'compact':
+            return 'compactModel';
+    }
+}
+/**
+ * Resolves the effective model id for a mode. The conversation modes
+ * (plan/execute) fall back to the legacy single `chatModel` when the per-mode
+ * field is unset (back-compat); the auxiliary jobs (commit/compact) do NOT —
+ * the server applies its own fast default for them, mirrored here by returning
+ * `undefined`.
+ *
+ * @param settings - The project's model settings.
+ * @param mode - The conversation mode or auxiliary job.
+ * @returns The resolved model id, or `undefined` when nothing is configured.
+ */
+export function resolveModeModel(settings, mode) {
+    switch (mode) {
+        case 'plan':
+            return settings.planModel ?? settings.chatModel;
+        case 'execute':
+            return settings.executeModel ?? settings.chatModel;
+        case 'commit':
+            return settings.commitModel;
+        case 'compact':
+            return settings.compactModel;
+    }
+}
+/**
+ * Computes the free-tier-allowed model id for a mode from the live catalog. The
+ * free/anon tier is clamped — with no mixing — to `deepseek-v4-pro` in plan
+ * mode and `deepseek-v4-flash` in execute mode (the auxiliary commit/compact
+ * jobs share the execute clamp), mirroring the server's FREE_TIER_MODELS.
+ * Matching is catalog-driven (by id/provider) so it survives id churn; when no
+ * specific match exists it falls back to the supplied `fallback` (the
+ * catalog's free-tier model id).
+ *
+ * @param models - The available models from the catalog.
+ * @param mode - The conversation mode or auxiliary job.
+ * @param fallback - The free-tier model id to use when no match is found.
+ * @returns The clamped model id for the mode.
+ */
+export function freeTierModeModelId(models, mode, fallback) {
+    if (mode === 'plan') {
+        const exact = models.find((m) => m.id === 'deepseek-v4-pro');
+        if (exact)
+            return exact.id;
+        const deepseekPro = models.find((m) => m.provider === 'deepseek' && /pro/i.test(m.id));
+        if (deepseekPro)
+            return deepseekPro.id;
+        const anyDeepseek = models.find((m) => m.provider === 'deepseek');
+        return anyDeepseek?.id ?? fallback;
+    }
+    // execute (and the commit/compact auxiliary jobs, which share its clamp)
+    const exact = models.find((m) => m.id === 'deepseek-v4-flash');
+    if (exact)
+        return exact.id;
+    const deepseekFlash = models.find((m) => m.provider === 'deepseek' && /flash/i.test(m.id));
+    if (deepseekFlash)
+        return deepseekFlash.id;
+    const anyDeepseek = models.find((m) => m.provider === 'deepseek');
+    return anyDeepseek?.id ?? fallback;
+}
+/** Every mode a per-mode clamp exists for — used to test "free elsewhere". */
+const MODEL_MODES = ['plan', 'execute', 'commit', 'compact'];
+/**
+ * The lock reason for a model in a mode under the free-tier clamp, or `null`
+ * when it is selectable. Pro users and `provider: 'custom'` (bring-your-own
+ * AI) models are never locked; a free/anon user may pick only the mode's
+ * clamped model (plan/execute) or any free-tier-flagged model (the auxiliary
+ * commit/compact jobs, mirroring the server's aux-model selection, which
+ * ignores a non-free platform pick anyway).
+ *
+ * A locked model splits into two very different cases the UI must not
+ * conflate: `'paid'` (upgrade actually unlocks it) versus `'mode'` (the model
+ * is free-tier-usable in ANOTHER mode — it is a different mode's clamp, or
+ * free-tier-flagged and thus selectable for commit/compact — so a "Pro" badge
+ * would be flatly wrong).
+ *
+ * @param modelId - The candidate model id.
+ * @param mode - The conversation mode the picker is scoped to.
+ * @param isFreeTier - Whether the current user is on the free/anon tier.
+ * @param models - The available models from the catalog.
+ * @param fallback - The free-tier model id to use when no clamp match is found.
+ * @returns `'paid'` / `'mode'` when locked, `null` when selectable.
+ */
+export function freeTierLockReason(modelId, mode, isFreeTier, models, fallback) {
+    if (!isFreeTier)
+        return null;
+    const candidate = models.find((m) => m.id === modelId);
+    if (candidate?.provider === 'custom')
+        return null;
+    const allowedHere = mode === 'commit' || mode === 'compact'
+        ? candidate?.freeTier === true
+        : modelId === freeTierModeModelId(models, mode, fallback);
+    if (allowedHere)
+        return null;
+    const freeElsewhere = candidate?.freeTier === true ||
+        MODEL_MODES.some((other) => other !== mode && modelId === freeTierModeModelId(models, other, fallback));
+    return freeElsewhere ? 'mode' : 'paid';
+}
+/**
+ * The mode a free-tier user can actually use this model in — `'plan'` /
+ * `'execute'` when it is that mode's clamp, `'commit'` (standing for both
+ * auxiliary jobs) when it is merely free-tier-flagged, `null` when the free
+ * tier can't use it anywhere. Drives the "free in <mode>" labeling next to a
+ * `'mode'`-locked row.
+ *
+ * @param modelId - The candidate model id.
+ * @param models - The available models from the catalog.
+ * @param fallback - The free-tier model id to use when no clamp match is found.
+ * @returns The mode the model is free-tier-usable in, or `null`.
+ */
+export function freeTierUsableMode(modelId, models, fallback) {
+    if (modelId === freeTierModeModelId(models, 'plan', fallback))
+        return 'plan';
+    if (modelId === freeTierModeModelId(models, 'execute', fallback))
+        return 'execute';
+    if (models.find((m) => m.id === modelId)?.freeTier === true)
+        return 'commit';
+    return null;
+}
+/**
+ * Whether a model is locked (not selectable) for the given mode under the
+ * free-tier clamp — the boolean view of {@link freeTierLockReason} (which see
+ * for the rules: pro users and custom models never lock; plan/execute clamp to
+ * one model; commit/compact accept any free-tier-flagged model).
+ *
+ * @param modelId - The candidate model id.
+ * @param mode - The conversation mode the picker is scoped to.
+ * @param isFreeTier - Whether the current user is on the free/anon tier.
+ * @param models - The available models from the catalog.
+ * @param fallback - The free-tier model id to use when no clamp match is found.
+ * @returns `true` when the model is locked for this user and mode.
+ */
+export function isModeModelLocked(modelId, mode, isFreeTier, models, fallback) {
+    return freeTierLockReason(modelId, mode, isFreeTier, models, fallback) !== null;
+}
+//# sourceMappingURL=chat-model-mode-utilities.js.map

package/dist/components/chat-model-mode-utilities.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"chat-model-mode-utilities.js","sourceRoot":"","sources":["../../src/components/chat-model-mode-utilities.ts"],"names":[],"mappings":"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"}

package/dist/components/chat-models-utilities.d.ts

@@ -0,0 +1,98 @@
+/**
+ * Pure helpers backing the `/models` comparison table.
+ *
+ * Sorting is split out from the React component so the comparator can be unit
+ * tested without rendering. All functions are deterministic and side-effect
+ * free.
+ *
+ * @module
+ */
+import type { AppModelDefinition } from '@molecule/app-ai-models';
+/**
+ * Sortable columns in the `/models` table.
+ *
+ * `cutoff` (knowledge-cutoff date) replaced a former `tier` column that was
+ * fabricated from input price: it duplicated the `cost` axis and was sometimes
+ * factually wrong (a slow reasoning model could read "Balanced"). The catalog
+ * has no latency field, so rather than invent one we expose `knowledgeCutoff` —
+ * a real, factual axis that is genuinely independent of price, context, and
+ * output size.
+ */
+export type ModelSortColumn = 'name' | 'context' | 'cost' | 'cutoff' | 'free' | 'region';
+/** Sort direction. */
+export type SortDirection = 'asc' | 'desc';
+/**
+ * Processing region of a model, as an arbitrary region code (`'us'`, `'cn'`,
+ * potentially `'eu'` etc. later). `'us'` is the platform default; deliberately
+ * NOT a closed union so adding a region never changes this contract.
+ */
+export type ModelProcessingRegion = string;
+/**
+ * Resolve a model's effective processing region: the requested region when the
+ * model's `regions` list offers it, else the model's DEFAULT region (the first
+ * listed; `'us'` when the catalog omits regions). A single-entry list pins the
+ * model regardless of the request. Mirrors the server-side
+ * `effectiveModelRegion` in `@molecule/api-resource-ai-models`.
+ *
+ * @param model - The model metadata.
+ * @param requested - The user's per-model region choice, if any.
+ * @returns The effective region code.
+ */
+export declare function effectiveModelRegion(model: AppModelDefinition, requested?: string): ModelProcessingRegion;
+/**
+ * Combined input + output price per million tokens, used as the single
+ * "cost/1M tokens" figure — at the rates of the model's effective region
+ * (`regionPricing` override when the region has one, else the base rates).
+ *
+ * @param model - The model metadata.
+ * @param region - The user's per-model region choice, if any (omitted → the
+ *   model's default region).
+ * @returns Sum of input and output price per million tokens in USD.
+ */
+export declare function modelTotalCost(model: AppModelDefinition, region?: string): number;
+/**
+ * Relative usage rate: how much faster this model consumes the user's AI
+ * allowance than the cheapest available model (a unitless `×N` multiplier,
+ * `1` for the cheapest). Derived from combined input+output list rates. This
+ * is the ONLY per-model "cost" figure user-facing surfaces show — AI usage is
+ * never presented as currency.
+ *
+ * The base is every model's DEFAULT-region cost (stable regardless of the
+ * user's per-model region choices); the rated model itself is priced at the
+ * given region so the figure tracks what a region switch actually changes.
+ *
+ * @param model - The model to rate.
+ * @param models - The full available-model list (supplies the cheapest base).
+ * @param region - The rated model's region choice, if any (omitted → its
+ *   default region).
+ * @returns The multiplier, rounded to 1 decimal below 10 and whole above.
+ */
+export declare function modelUsageRate(model: AppModelDefinition, models: readonly AppModelDefinition[], region?: string): number;
+/**
+ * Ascending comparator for two models by the given column. Returns a negative,
+ * zero, or positive number suitable for `Array.prototype.sort`. Ties fall back
+ * to label order so the sort is stable and deterministic.
+ *
+ * @param a - First model.
+ * @param b - Second model.
+ * @param column - Column to compare by.
+ * @param regionOf - Resolves a model's effective processing region (used by
+ *   the `'region'` and `'cost'` columns; omitting it treats every model as its
+ *   default region). The caller supplies this because the effective region
+ *   depends on per-project settings the pure helper cannot know.
+ * @returns Negative if `a` sorts before `b`, positive if after, zero if equal.
+ */
+export declare function compareModels(a: AppModelDefinition, b: AppModelDefinition, column: ModelSortColumn, regionOf?: (model: AppModelDefinition) => ModelProcessingRegion): number;
+/**
+ * Returns a new array of models sorted by the given column and direction.
+ * Does not mutate the input.
+ *
+ * @param models - Models to sort.
+ * @param column - Column to sort by.
+ * @param direction - `'asc'` or `'desc'`.
+ * @param regionOf - Resolves a model's effective processing region (used by
+ *   the `'region'` and `'cost'` columns). See {@link compareModels}.
+ * @returns A new, sorted array.
+ */
+export declare function sortModels(models: readonly AppModelDefinition[], column: ModelSortColumn, direction: SortDirection, regionOf?: (model: AppModelDefinition) => ModelProcessingRegion): AppModelDefinition[];
+//# sourceMappingURL=chat-models-utilities.d.ts.map

package/dist/components/chat-models-utilities.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chat-models-utilities.d.ts","sourceRoot":"","sources":["../../src/components/chat-models-utilities.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAA;AAEjE;;;;;;;;;GASG;AACH,MAAM,MAAM,eAAe,GAAG,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,QAAQ,GAAG,MAAM,GAAG,QAAQ,CAAA;AAExF,sBAAsB;AACtB,MAAM,MAAM,aAAa,GAAG,KAAK,GAAG,MAAM,CAAA;AAE1C;;;;GAIG;AACH,MAAM,MAAM,qBAAqB,GAAG,MAAM,CAAA;AAE1C;;;;;;;;;;GAUG;AACH,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,kBAAkB,EACzB,SAAS,CAAC,EAAE,MAAM,GACjB,qBAAqB,CAGvB;AAED;;;;;;;;;GASG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,kBAAkB,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAKjF;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,cAAc,CAC5B,KAAK,EAAE,kBAAkB,EACzB,MAAM,EAAE,SAAS,kBAAkB,EAAE,EACrC,MAAM,CAAC,EAAE,MAAM,GACd,MAAM,CAMR;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,aAAa,CAC3B,CAAC,EAAE,kBAAkB,EACrB,CAAC,EAAE,kBAAkB,EACrB,MAAM,EAAE,eAAe,EACvB,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,kBAAkB,KAAK,qBAAqB,GAC9D,MAAM,CAoCR;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,UAAU,CACxB,MAAM,EAAE,SAAS,kBAAkB,EAAE,EACrC,MAAM,EAAE,eAAe,EACvB,SAAS,EAAE,aAAa,EACxB,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,kBAAkB,KAAK,qBAAqB,GAC9D,kBAAkB,EAAE,CAQtB"}

package/dist/components/chat-models-utilities.js

@@ -0,0 +1,136 @@
+/**
+ * Pure helpers backing the `/models` comparison table.
+ *
+ * Sorting is split out from the React component so the comparator can be unit
+ * tested without rendering. All functions are deterministic and side-effect
+ * free.
+ *
+ * @module
+ */
+/**
+ * Resolve a model's effective processing region: the requested region when the
+ * model's `regions` list offers it, else the model's DEFAULT region (the first
+ * listed; `'us'` when the catalog omits regions). A single-entry list pins the
+ * model regardless of the request. Mirrors the server-side
+ * `effectiveModelRegion` in `@molecule/api-resource-ai-models`.
+ *
+ * @param model - The model metadata.
+ * @param requested - The user's per-model region choice, if any.
+ * @returns The effective region code.
+ */
+export function effectiveModelRegion(model, requested) {
+    const regions = model.regions ?? ['us'];
+    return requested && regions.includes(requested) ? requested : regions[0];
+}
+/**
+ * Combined input + output price per million tokens, used as the single
+ * "cost/1M tokens" figure — at the rates of the model's effective region
+ * (`regionPricing` override when the region has one, else the base rates).
+ *
+ * @param model - The model metadata.
+ * @param region - The user's per-model region choice, if any (omitted → the
+ *   model's default region).
+ * @returns Sum of input and output price per million tokens in USD.
+ */
+export function modelTotalCost(model, region) {
+    const override = model.regionPricing?.[effectiveModelRegion(model, region)];
+    return override
+        ? override.inputPricePerMTok + override.outputPricePerMTok
+        : model.inputPricePerMTok + model.outputPricePerMTok;
+}
+/**
+ * Relative usage rate: how much faster this model consumes the user's AI
+ * allowance than the cheapest available model (a unitless `×N` multiplier,
+ * `1` for the cheapest). Derived from combined input+output list rates. This
+ * is the ONLY per-model "cost" figure user-facing surfaces show — AI usage is
+ * never presented as currency.
+ *
+ * The base is every model's DEFAULT-region cost (stable regardless of the
+ * user's per-model region choices); the rated model itself is priced at the
+ * given region so the figure tracks what a region switch actually changes.
+ *
+ * @param model - The model to rate.
+ * @param models - The full available-model list (supplies the cheapest base).
+ * @param region - The rated model's region choice, if any (omitted → its
+ *   default region).
+ * @returns The multiplier, rounded to 1 decimal below 10 and whole above.
+ */
+export function modelUsageRate(model, models, region) {
+    const costs = models.map((m) => modelTotalCost(m)).filter((c) => c > 0);
+    const base = costs.length > 0 ? Math.min(...costs) : 0;
+    if (!Number.isFinite(base) || base <= 0)
+        return 1;
+    const rate = modelTotalCost(model, region) / base;
+    return rate >= 10 ? Math.round(rate) : Math.max(1, Math.round(rate * 10) / 10);
+}
+/**
+ * Ascending comparator for two models by the given column. Returns a negative,
+ * zero, or positive number suitable for `Array.prototype.sort`. Ties fall back
+ * to label order so the sort is stable and deterministic.
+ *
+ * @param a - First model.
+ * @param b - Second model.
+ * @param column - Column to compare by.
+ * @param regionOf - Resolves a model's effective processing region (used by
+ *   the `'region'` and `'cost'` columns; omitting it treats every model as its
+ *   default region). The caller supplies this because the effective region
+ *   depends on per-project settings the pure helper cannot know.
+ * @returns Negative if `a` sorts before `b`, positive if after, zero if equal.
+ */
+export function compareModels(a, b, column, regionOf) {
+    let primary;
+    switch (column) {
+        case 'name':
+            primary = a.label.localeCompare(b.label);
+            break;
+        case 'context':
+            primary = a.contextWindow - b.contextWindow;
+            break;
+        case 'cost':
+            // Region-aware: a model flipped to a differently-priced region sorts by
+            // the cost it actually bills at.
+            primary = modelTotalCost(a, regionOf?.(a)) - modelTotalCost(b, regionOf?.(b));
+            break;
+        case 'cutoff':
+            // Knowledge-cutoff dates are YYYY-MM-DD strings, which sort
+            // lexicographically as dates. Ascending puts the oldest training data
+            // first.
+            primary = a.knowledgeCutoff.localeCompare(b.knowledgeCutoff);
+            break;
+        case 'free':
+            // Free-tier models sort first in ascending order.
+            primary = (b.freeTier ? 1 : 0) - (a.freeTier ? 1 : 0);
+            break;
+        case 'region': {
+            // US-processed (platform-default) models sort first ascending; other
+            // regions follow alphabetically by region code.
+            const ra = regionOf?.(a) ?? 'us';
+            const rb = regionOf?.(b) ?? 'us';
+            primary = ra === rb ? 0 : ra === 'us' ? -1 : rb === 'us' ? 1 : ra.localeCompare(rb);
+            break;
+        }
+    }
+    if (primary !== 0)
+        return primary;
+    // Stable tiebreak by label so equal rows keep a deterministic order.
+    return a.label.localeCompare(b.label);
+}
+/**
+ * Returns a new array of models sorted by the given column and direction.
+ * Does not mutate the input.
+ *
+ * @param models - Models to sort.
+ * @param column - Column to sort by.
+ * @param direction - `'asc'` or `'desc'`.
+ * @param regionOf - Resolves a model's effective processing region (used by
+ *   the `'region'` and `'cost'` columns). See {@link compareModels}.
+ * @returns A new, sorted array.
+ */
+export function sortModels(models, column, direction, regionOf) {
+    // Swapping the comparator arguments for `'desc'` fully reverses the order
+    // (including the label tiebreak) without relying on Array#sort stability.
+    return [...models].sort((a, b) => direction === 'desc'
+        ? compareModels(b, a, column, regionOf)
+        : compareModels(a, b, column, regionOf));
+}
+//# sourceMappingURL=chat-models-utilities.js.map

package/dist/components/chat-models-utilities.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"chat-models-utilities.js","sourceRoot":"","sources":["../../src/components/chat-models-utilities.ts"],"names":[],"mappings":"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"}