@calliopelabs/cli 3.2.1 → 3.3.0

package/dist/judgment/policy.d.ts

@@ -0,0 +1,61 @@
+import { type Answer, type JudgmentEngine, type JudgmentResponse, type Question } from './types.js';
+/** Exactly one operator per rule, matching its question's primitive. */
+export interface DenyRule {
+    question: string;
+    reason: string;
+    /** noul: deny when the probability of yes exceeds this. */
+    above?: number;
+    /** choice: deny when this option is selected. */
+    is?: string;
+    /** score: deny when the weighted level reaches this. */
+    atLeast?: number;
+    /** choice/score: ignore the match below this confidence. */
+    minConfidence?: number;
+}
+export interface PolicyRules {
+    questions: Record<string, Question>;
+    deny: DenyRule[];
+}
+export interface PolicyVerdict {
+    decision: 'allow' | 'deny';
+    reason?: string;
+    rule?: DenyRule;
+}
+/**
+ * Validate rules against their own questions, so a typo or a mismatched
+ * operator fails when the policy is written rather than when a tool is judged.
+ */
+export declare function validatePolicyRules(input: unknown): PolicyRules;
+/** Deny wins, and the first matching rule supplies the reason. */
+export declare function decidePolicy(rules: PolicyRules, answers: Record<string, Answer>): PolicyVerdict;
+/** A configured engine name is operator input, so it is checked like any other. */
+export declare function validateJudgmentEngine(value: unknown): JudgmentEngine;
+export interface JudgeToolCallOptions {
+    rulesPath: string;
+    provider?: JudgmentEngine;
+    model?: string;
+    signal?: AbortSignal;
+}
+/**
+ * Judge one pending tool call against a rules file. Shared by the CLI engine
+ * and the built-in `policy.judgment` setting so both decide identically.
+ */
+export declare function judgeToolCall(toolCall: unknown, options: JudgeToolCallOptions): Promise<{
+    verdict: PolicyVerdict;
+    response: JudgmentResponse;
+}>;
+export interface PolicyRunOptions {
+    provider?: JudgmentEngine;
+    model?: string;
+    signal?: AbortSignal;
+    json?: boolean;
+    stdin?: () => string;
+    write?: (text: string) => void;
+    writeErr?: (text: string) => void;
+}
+/**
+ * Exit 0 allows, 1 denies by rule, 2 denies because the engine could not decide.
+ * The hook treats every non-zero exit as a denial and reads stderr as the reason.
+ */
+export declare function runJudgePolicy(rulesPath: string, options?: PolicyRunOptions): Promise<number>;
+//# sourceMappingURL=policy.d.ts.map

package/dist/judgment/policy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"policy.d.ts","sourceRoot":"","sources":["../../src/judgment/policy.ts"],"names":[],"mappings":"AASA,OAAO,EAAiB,KAAK,MAAM,EAAE,KAAK,cAAc,EAAE,KAAK,gBAAgB,EAAE,KAAK,QAAQ,EAAE,MAAM,YAAY,CAAC;AAEnH,wEAAwE;AACxE,MAAM,WAAW,QAAQ;IACvB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,2DAA2D;IAC3D,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,iDAAiD;IACjD,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,wDAAwD;IACxD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,4DAA4D;IAC5D,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,WAAW;IAC1B,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;IACpC,IAAI,EAAE,QAAQ,EAAE,CAAC;CAClB;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,OAAO,GAAG,MAAM,CAAC;IAC3B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,QAAQ,CAAC;CACjB;AAaD;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,OAAO,GAAG,WAAW,CAwC/D;AAED,kEAAkE;AAClE,wBAAgB,YAAY,CAAC,KAAK,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,aAAa,CAW/F;AAED,mFAAmF;AACnF,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,OAAO,GAAG,cAAc,CAKrE;AAED,MAAM,WAAW,oBAAoB;IACnC,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,cAAc,CAAC;IAC1B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAED;;;GAGG;AACH,wBAAsB,aAAa,CAAC,QAAQ,EAAE,OAAO,EAAE,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAAC;IAAE,OAAO,EAAE,aAAa,CAAC;IAAC,QAAQ,EAAE,gBAAgB,CAAA;CAAE,CAAC,CAKrJ;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,EAAE,cAAc,CAAC;IAC1B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,MAAM,CAAC;IACrB,KAAK,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAC/B,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;CACnC;AAED;;;GAGG;AACH,wBAAsB,cAAc,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,GAAE,gBAAqB,GAAG,OAAO,CAAC,MAAM,CAAC,CAkBvG"}

package/dist/judgment/policy.js

@@ -0,0 +1,143 @@
+/**
+ * Judgment-backed policy engine for the pre-tool hook (see docs/governance.md).
+ * Reads a pending tool call on stdin, judges it against reviewed questions, and
+ * exits 0 to allow or non-zero to deny. Every failure denies: a policy engine
+ * that cannot decide must never wave a tool through.
+ */
+import * as fs from 'node:fs';
+import * as config from '../config.js';
+import { evaluate } from './evaluate.js';
+import { JudgmentError } from './types.js';
+function invalid(message) { throw new JudgmentError('invalid-request', message); }
+function isRecord(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+function probability(id, field, value) {
+    if (typeof value !== 'number' || !Number.isFinite(value) || value < 0 || value > 1)
+        invalid(`Rule for "${id}": "${field}" must be a number between 0 and 1.`);
+    return value;
+}
+/**
+ * Validate rules against their own questions, so a typo or a mismatched
+ * operator fails when the policy is written rather than when a tool is judged.
+ */
+export function validatePolicyRules(input) {
+    if (!isRecord(input))
+        invalid('Policy rules must be an object with "questions" and "deny".');
+    if (!isRecord(input.questions))
+        invalid('Policy rules need a "questions" map.');
+    if (!Array.isArray(input.deny) || input.deny.length === 0)
+        invalid('Policy rules need a non-empty "deny" array.');
+    const questions = input.questions;
+    const deny = input.deny.map((value, index) => {
+        if (!isRecord(value))
+            invalid(`Deny rule ${index} must be an object.`);
+        const id = value.question;
+        if (typeof id !== 'string' || !Object.hasOwn(questions, id))
+            invalid(`Deny rule ${index} names unknown question ${JSON.stringify(id)}.`);
+        if (typeof value.reason !== 'string' || !value.reason.trim())
+            invalid(`Deny rule for "${id}" needs a reason.`);
+        const question = questions[id];
+        const operators = ['above', 'is', 'atLeast'].filter(name => value[name] !== undefined);
+        if (operators.length !== 1)
+            invalid(`Deny rule for "${id}" needs exactly one of above, is or atLeast.`);
+        const rule = { question: id, reason: value.reason };
+        if (value.minConfidence !== undefined) {
+            if (question.type === 'noul')
+                invalid(`Deny rule for "${id}": a noul answer carries no confidence.`);
+            rule.minConfidence = probability(id, 'minConfidence', value.minConfidence);
+        }
+        switch (operators[0]) {
+            case 'above':
+                if (question.type !== 'noul')
+                    invalid(`Deny rule for "${id}": "above" applies to a noul question.`);
+                rule.above = probability(id, 'above', value.above);
+                break;
+            case 'is': {
+                if (question.type !== 'choice')
+                    invalid(`Deny rule for "${id}": "is" applies to a choice question.`);
+                if (typeof value.is !== 'string' || !Object.hasOwn(question.criteria, value.is))
+                    invalid(`Deny rule for "${id}": "is" must name one of its options.`);
+                rule.is = value.is;
+                break;
+            }
+            default: {
+                if (question.type !== 'score')
+                    invalid(`Deny rule for "${id}": "atLeast" applies to a score question.`);
+                const levels = question.criteria.length - 1;
+                if (typeof value.atLeast !== 'number' || !Number.isFinite(value.atLeast) || value.atLeast < 0 || value.atLeast > levels)
+                    invalid(`Deny rule for "${id}": "atLeast" must be between 0 and ${levels}.`);
+                rule.atLeast = value.atLeast;
+                break;
+            }
+        }
+        return rule;
+    });
+    return { questions, deny };
+}
+/** Deny wins, and the first matching rule supplies the reason. */
+export function decidePolicy(rules, answers) {
+    for (const rule of rules.deny) {
+        const answer = answers[rule.question];
+        if (!answer)
+            throw new JudgmentError('model-output', `No answer returned for question "${rule.question}".`);
+        if (rule.minConfidence !== undefined && 'confidence' in answer && answer.confidence < rule.minConfidence)
+            continue;
+        const matched = answer.type === 'noul' ? rule.above !== undefined && answer.noul > rule.above
+            : answer.type === 'choice' ? answer.choice === rule.is
+                : rule.atLeast !== undefined && answer.score >= rule.atLeast;
+        if (matched)
+            return { decision: 'deny', reason: rule.reason, rule };
+    }
+    return { decision: 'allow' };
+}
+/** A configured engine name is operator input, so it is checked like any other. */
+export function validateJudgmentEngine(value) {
+    if (value === 'typesafe')
+        return 'typesafe';
+    if (typeof value !== 'string' || (value !== 'auto' && !config.getProviderNames().includes(value)))
+        invalid(`Unknown judgment provider ${JSON.stringify(value)}.`);
+    return value;
+}
+/**
+ * Judge one pending tool call against a rules file. Shared by the CLI engine
+ * and the built-in `policy.judgment` setting so both decide identically.
+ */
+export async function judgeToolCall(toolCall, options) {
+    const rules = validatePolicyRules(JSON.parse(fs.readFileSync(options.rulesPath, 'utf8')));
+    if (!isRecord(toolCall))
+        invalid('The pending tool call must be a JSON object.');
+    const response = await evaluate({ state: toolCall, questions: rules.questions }, { provider: options.provider, model: options.model, signal: options.signal });
+    return { verdict: decidePolicy(rules, response.answers), response };
+}
+/**
+ * Exit 0 allows, 1 denies by rule, 2 denies because the engine could not decide.
+ * The hook treats every non-zero exit as a denial and reads stderr as the reason.
+ */
+export async function runJudgePolicy(rulesPath, options = {}) {
+    const write = options.write ?? ((text) => { process.stdout.write(text); });
+    const writeErr = options.writeErr ?? ((text) => { process.stderr.write(text); });
+    const stdin = options.stdin ?? (() => fs.readFileSync(0, 'utf8'));
+    try {
+        let toolCall;
+        try {
+            toolCall = JSON.parse(stdin());
+        }
+        catch {
+            invalid('The pending tool call on stdin is not valid JSON.');
+        }
+        const { verdict, response } = await judgeToolCall(toolCall, { rulesPath, ...(options.provider ? { provider: options.provider } : {}), ...(options.model ? { model: options.model } : {}), ...(options.signal ? { signal: options.signal } : {}) });
+        if (options.json)
+            write(JSON.stringify({ version: 1, type: 'judgment-policy', ...verdict, provider: response.provider, model: response.model, answers: response.answers, usage: response.usage }) + '\n');
+        if (verdict.decision === 'allow')
+            return 0;
+        writeErr(`${verdict.reason}\n`);
+        return 1;
+    }
+    catch (error) {
+        const message = error instanceof JudgmentError || error instanceof Error ? error.message : String(error);
+        writeErr(`policy engine could not decide: ${message}\n`);
+        return 2;
+    }
+}
+//# sourceMappingURL=policy.js.map

package/dist/judgment/policy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"policy.js","sourceRoot":"","sources":["../../src/judgment/policy.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAC9B,OAAO,KAAK,MAAM,MAAM,cAAc,CAAC;AACvC,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,OAAO,EAAE,aAAa,EAA0E,MAAM,YAAY,CAAC;AA2BnH,SAAS,OAAO,CAAC,OAAe,IAAW,MAAM,IAAI,aAAa,CAAC,iBAAiB,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC;AAEjG,SAAS,QAAQ,CAAC,KAAc;IAC9B,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AAC9E,CAAC;AAED,SAAS,WAAW,CAAC,EAAU,EAAE,KAAa,EAAE,KAAc;IAC5D,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,KAAK,GAAG,CAAC,IAAI,KAAK,GAAG,CAAC;QAAE,OAAO,CAAC,aAAa,EAAE,OAAO,KAAK,qCAAqC,CAAC,CAAC;IAC9J,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,mBAAmB,CAAC,KAAc;IAChD,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC;QAAE,OAAO,CAAC,6DAA6D,CAAC,CAAC;IAC7F,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,SAAS,CAAC;QAAE,OAAO,CAAC,sCAAsC,CAAC,CAAC;IAChF,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,KAAK,CAAC,IAAI,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,CAAC,6CAA6C,CAAC,CAAC;IAClH,MAAM,SAAS,GAAG,KAAK,CAAC,SAAqC,CAAC;IAC9D,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE;QAC3C,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC;YAAE,OAAO,CAAC,aAAa,KAAK,qBAAqB,CAAC,CAAC;QACvE,MAAM,EAAE,GAAG,KAAK,CAAC,QAAQ,CAAC;QAC1B,IAAI,OAAO,EAAE,KAAK,QAAQ,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,SAAS,EAAE,EAAE,CAAC;YAAE,OAAO,CAAC,aAAa,KAAK,2BAA2B,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC;QACzI,IAAI,OAAO,KAAK,CAAC,MAAM,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,EAAE;YAAE,OAAO,CAAC,kBAAkB,EAAE,mBAAmB,CAAC,CAAC;QAC/G,MAAM,QAAQ,GAAG,SAAS,CAAC,EAAE,CAAE,CAAC;QAChC,MAAM,SAAS,GAAI,CAAC,OAAO,EAAE,IAAI,EAAE,SAAS,CAAW,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,SAAS,CAAC,CAAC;QAClG,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,CAAC,kBAAkB,EAAE,8CAA8C,CAAC,CAAC;QACxG,MAAM,IAAI,GAAa,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,CAAC;QAC9D,IAAI,KAAK,CAAC,aAAa,KAAK,SAAS,EAAE,CAAC;YACtC,IAAI,QAAQ,CAAC,IAAI,KAAK,MAAM;gBAAE,OAAO,CAAC,kBAAkB,EAAE,yCAAyC,CAAC,CAAC;YACrG,IAAI,CAAC,aAAa,GAAG,WAAW,CAAC,EAAE,EAAE,eAAe,EAAE,KAAK,CAAC,aAAa,CAAC,CAAC;QAC7E,CAAC;QACD,QAAQ,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC;YACrB,KAAK,OAAO;gBACV,IAAI,QAAQ,CAAC,IAAI,KAAK,MAAM;oBAAE,OAAO,CAAC,kBAAkB,EAAE,wCAAwC,CAAC,CAAC;gBACpG,IAAI,CAAC,KAAK,GAAG,WAAW,CAAC,EAAE,EAAE,OAAO,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC;gBACnD,MAAM;YACR,KAAK,IAAI,EAAE,CAAC;gBACV,IAAI,QAAQ,CAAC,IAAI,KAAK,QAAQ;oBAAE,OAAO,CAAC,kBAAkB,EAAE,uCAAuC,CAAC,CAAC;gBACrG,IAAI,OAAO,KAAK,CAAC,EAAE,KAAK,QAAQ,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,QAAQ,EAAE,KAAK,CAAC,EAAE,CAAC;oBAAE,OAAO,CAAC,kBAAkB,EAAE,uCAAuC,CAAC,CAAC;gBACtJ,IAAI,CAAC,EAAE,GAAG,KAAK,CAAC,EAAE,CAAC;gBACnB,MAAM;YACR,CAAC;YACD,SAAS,CAAC;gBACR,IAAI,QAAQ,CAAC,IAAI,KAAK,OAAO;oBAAE,OAAO,CAAC,kBAAkB,EAAE,2CAA2C,CAAC,CAAC;gBACxG,MAAM,MAAM,GAAG,QAAQ,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC;gBAC5C,IAAI,OAAO,KAAK,CAAC,OAAO,KAAK,QAAQ,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,KAAK,CAAC,OAAO,GAAG,CAAC,IAAI,KAAK,CAAC,OAAO,GAAG,MAAM;oBAAE,OAAO,CAAC,kBAAkB,EAAE,sCAAsC,MAAM,GAAG,CAAC,CAAC;gBACtM,IAAI,CAAC,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC;gBAC7B,MAAM;YACR,CAAC;QACH,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC,CAAC,CAAC;IACH,OAAO,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC;AAC7B,CAAC;AAED,kEAAkE;AAClE,MAAM,UAAU,YAAY,CAAC,KAAkB,EAAE,OAA+B;IAC9E,KAAK,MAAM,IAAI,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC;QAC9B,MAAM,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QACtC,IAAI,CAAC,MAAM;YAAE,MAAM,IAAI,aAAa,CAAC,cAAc,EAAE,oCAAoC,IAAI,CAAC,QAAQ,IAAI,CAAC,CAAC;QAC5G,IAAI,IAAI,CAAC,aAAa,KAAK,SAAS,IAAI,YAAY,IAAI,MAAM,IAAI,MAAM,CAAC,UAAU,GAAG,IAAI,CAAC,aAAa;YAAE,SAAS;QACnH,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,KAAK,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,KAAK,SAAS,IAAI,MAAM,CAAC,IAAI,GAAG,IAAI,CAAC,KAAK;YAC3F,CAAC,CAAC,MAAM,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,KAAK,IAAI,CAAC,EAAE;gBACtD,CAAC,CAAC,IAAI,CAAC,OAAO,KAAK,SAAS,IAAI,MAAM,CAAC,KAAK,IAAI,IAAI,CAAC,OAAO,CAAC;QAC/D,IAAI,OAAO;YAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC;IACtE,CAAC;IACD,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC;AAC/B,CAAC;AAED,mFAAmF;AACnF,MAAM,UAAU,sBAAsB,CAAC,KAAc;IACnD,IAAI,KAAK,KAAK,UAAU;QAAE,OAAO,UAAU,CAAC;IAC5C,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,KAAK,KAAK,MAAM,IAAI,CAAC,MAAM,CAAC,gBAAgB,EAAE,CAAC,QAAQ,CAAC,KAAc,CAAC,CAAC;QACxG,OAAO,CAAC,6BAA6B,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IACjE,OAAO,KAAuB,CAAC;AACjC,CAAC;AASD;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,QAAiB,EAAE,OAA6B;IAClF,MAAM,KAAK,GAAG,mBAAmB,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,YAAY,CAAC,OAAO,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC;IAC1F,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC;QAAE,OAAO,CAAC,8CAA8C,CAAC,CAAC;IACjF,MAAM,QAAQ,GAAG,MAAM,QAAQ,CAAC,EAAE,KAAK,EAAE,QAAQ,EAAE,SAAS,EAAE,KAAK,CAAC,SAAS,EAAE,EAAE,EAAE,QAAQ,EAAE,OAAO,CAAC,QAAQ,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IAC/J,OAAO,EAAE,OAAO,EAAE,YAAY,CAAC,KAAK,EAAE,QAAQ,CAAC,OAAO,CAAC,EAAE,QAAQ,EAAE,CAAC;AACtE,CAAC;AAYD;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,SAAiB,EAAE,OAAO,GAAqB,EAAE;IACpF,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,IAAI,CAAC,CAAC,IAAY,EAAE,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACnF,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,IAAI,CAAC,CAAC,IAAY,EAAE,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACzF,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,IAAI,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,YAAY,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC;IAClE,IAAI,CAAC;QACH,IAAI,QAAiB,CAAC;QACtB,IAAI,CAAC;YAAC,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC,CAAC;QAAC,CAAC;QACvC,MAAM,CAAC;YAAC,OAAO,CAAC,mDAAmD,CAAC,CAAC;QAAC,CAAC;QACvE,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,GAAG,MAAM,aAAa,CAAC,QAAQ,EAAE,EAAE,SAAS,EAAE,GAAG,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,GAAG,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,GAAG,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;QACnP,IAAI,OAAO,CAAC,IAAI;YAAE,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,iBAAiB,EAAE,GAAG,OAAO,EAAE,QAAQ,EAAE,QAAQ,CAAC,QAAQ,EAAE,KAAK,EAAE,QAAQ,CAAC,KAAK,EAAE,OAAO,EAAE,QAAQ,CAAC,OAAO,EAAE,KAAK,EAAE,QAAQ,CAAC,KAAK,EAAE,CAAC,GAAG,IAAI,CAAC,CAAC;QAC1M,IAAI,OAAO,CAAC,QAAQ,KAAK,OAAO;YAAE,OAAO,CAAC,CAAC;QAC3C,QAAQ,CAAC,GAAG,OAAO,CAAC,MAAM,IAAI,CAAC,CAAC;QAChC,OAAO,CAAC,CAAC;IACX,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,OAAO,GAAG,KAAK,YAAY,aAAa,IAAI,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACzG,QAAQ,CAAC,mCAAmC,OAAO,IAAI,CAAC,CAAC;QACzD,OAAO,CAAC,CAAC;IACX,CAAC;AACH,CAAC"}

package/dist/judgment/types.d.ts

@@ -0,0 +1,73 @@
+/**
+ * Typed judgments: small, composable units of semantic judgment that code can
+ * threshold, weight and combine. One request evaluates a `state` against a map
+ * of typed questions and returns one probabilistic answer per question.
+ */
+import type { LLMProvider } from '../types.js';
+/** Any chat backend (prompted judgments) or the native TypeSafe endpoint. */
+export type JudgmentEngine = LLMProvider | 'typesafe';
+/** Free text, or structured guidance (definitions, contrasts, examples). */
+export type Instructions = string | Record<string, unknown> | unknown[];
+/** A yes/no judgment. The answer is the probability of yes. */
+export interface NoulQuestion {
+    type: 'noul';
+    instructions: Instructions;
+    criteria?: {
+        true?: string;
+        false?: string;
+    };
+}
+/** One option from a defined set. `null` means the option needs no rubric. */
+export interface ChoiceQuestion {
+    type: 'choice';
+    instructions: Instructions;
+    criteria: Record<string, string | null>;
+}
+/** A position along ordered levels; the answer can land between levels. */
+export interface ScoreQuestion {
+    type: 'score';
+    instructions: Instructions;
+    criteria: string[];
+}
+export type Question = NoulQuestion | ChoiceQuestion | ScoreQuestion;
+export interface JudgmentRequest {
+    /** Text or structured data to judge. */
+    state: unknown;
+    /** Keys are for the caller's code; they are never sent to the model. */
+    questions: Record<string, Question>;
+}
+export interface NoulAnswer {
+    type: 'noul';
+    noul: number;
+}
+export interface ChoiceAnswer {
+    type: 'choice';
+    choice: string;
+    probabilities: Record<string, number>;
+    /** How far the leading outcome sits above chance: 1 is peaked, 0 is uniform. */
+    confidence: number;
+}
+export interface ScoreAnswer {
+    type: 'score';
+    /** Probability-weighted level index; between levels is a valid result. */
+    score: number;
+    legend: Record<string, string>;
+    probabilities: Record<string, number>;
+    confidence: number;
+}
+export type Answer = NoulAnswer | ChoiceAnswer | ScoreAnswer;
+export interface JudgmentResponse {
+    provider: JudgmentEngine;
+    model: string;
+    answers: Record<string, Answer>;
+    usage: {
+        input_tokens: number;
+        output_tokens: number;
+    };
+}
+export type JudgmentErrorCode = 'invalid-request' | 'model-output' | 'unavailable';
+export declare class JudgmentError extends Error {
+    readonly code: JudgmentErrorCode;
+    constructor(code: JudgmentErrorCode, message: string);
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/judgment/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/judgment/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE/C,6EAA6E;AAC7E,MAAM,MAAM,cAAc,GAAG,WAAW,GAAG,UAAU,CAAC;AAEtD,4EAA4E;AAC5E,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,EAAE,CAAC;AAExE,+DAA+D;AAC/D,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,YAAY,CAAC;IAC3B,QAAQ,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CAC9C;AAED,8EAA8E;AAC9E,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,QAAQ,CAAC;IACf,YAAY,EAAE,YAAY,CAAC;IAC3B,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC,CAAC;CACzC;AAED,2EAA2E;AAC3E,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,OAAO,CAAC;IACd,YAAY,EAAE,YAAY,CAAC;IAC3B,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,MAAM,MAAM,QAAQ,GAAG,YAAY,GAAG,cAAc,GAAG,aAAa,CAAC;AAErE,MAAM,WAAW,eAAe;IAC9B,wCAAwC;IACxC,KAAK,EAAE,OAAO,CAAC;IACf,wEAAwE;IACxE,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;CACrC;AAED,MAAM,WAAW,UAAU;IAAG,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE;AAC1D,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,QAAQ,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACtC,gFAAgF;IAChF,UAAU,EAAE,MAAM,CAAC;CACpB;AACD,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,OAAO,CAAC;IACd,0EAA0E;IAC1E,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC/B,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACtC,UAAU,EAAE,MAAM,CAAC;CACpB;AACD,MAAM,MAAM,MAAM,GAAG,UAAU,GAAG,YAAY,GAAG,WAAW,CAAC;AAE7D,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,cAAc,CAAC;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,KAAK,EAAE;QAAE,YAAY,EAAE,MAAM,CAAC;QAAC,aAAa,EAAE,MAAM,CAAA;KAAE,CAAC;CACxD;AAED,MAAM,MAAM,iBAAiB,GAAG,iBAAiB,GAAG,cAAc,GAAG,aAAa,CAAC;AAEnF,qBAAa,aAAc,SAAQ,KAAK;IAC1B,QAAQ,CAAC,IAAI,EAAE,iBAAiB;IAA5C,YAAqB,IAAI,EAAE,iBAAiB,EAAE,OAAO,EAAE,MAAM,EAG5D;CACF"}

package/dist/judgment/types.js

@@ -0,0 +1,9 @@
+export class JudgmentError extends Error {
+    code;
+    constructor(code, message) {
+        super(message);
+        this.code = code;
+        this.name = 'JudgmentError';
+    }
+}
+//# sourceMappingURL=types.js.map

package/dist/judgment/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/judgment/types.ts"],"names":[],"mappings":"AAsEA,MAAM,OAAO,aAAc,SAAQ,KAAK;IACjB,IAAI;IAAzB,YAAqB,IAAuB,EAAE,OAAe;QAC3D,KAAK,CAAC,OAAO,CAAC,CAAC;oBADI,IAAI;QAEvB,IAAI,CAAC,IAAI,GAAG,eAAe,CAAC;IAC9B,CAAC;CACF"}

package/dist/model-detection.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"model-detection.d.ts","sourceRoot":"","sources":["../src/model-detection.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAMH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAK9C,OAAO,EAA+I,KAAK,SAAS,EAA0B,MAAM,mBAAmB,CAAC;AACxN,YAAY,EAAE,SAAS,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAItE,MAAM,WAAW,iBAAiB;IAChC,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,mFAAmF;IACnF,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;yEACqE;IACrE,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB;AAoCD,wFAAwF;AACxF,wBAAsB,kBAAkB,CAAC,QAAQ,EAAE,WAAW,EAAE,OAAO,GAAE,iBAAsB,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC,CAMrH;AAyHD,8EAA8E;AAC9E,wBAAgB,2BAA2B,CAAC,QAAQ,EAAE,WAAW,GAAG,SAAS,EAAE,GAAG,SAAS,CAG1F;AAMD,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,WAAW,GAAG,SAAS,EAAE,GAAG,SAAS,CAIlF;AAED,+EAA+E;AAC/E,wBAAsB,iBAAiB,CAAC,QAAQ,EAAE,WAAW,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,SAAS,GAAG,SAAS,CAAC,CAoBlI;AAED;;GAEG;AACH,wBAAsB,wBAAwB,CAAC,QAAQ,EAAE,WAAW,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAqC5F;AAydD;;;GAGG;AACH,wBAAsB,sBAAsB,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAqBrE;AA8ZD;;GAEG;AACH,wBAAgB,eAAe,CAAC,QAAQ,CAAC,EAAE,WAAW,GAAG,IAAI,CAQ5D;AAED;;;GAGG;AACH,wBAAsB,iBAAiB,CAAC,YAAY,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CASjF;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS,CAY1F;AAwDD;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAmBnF;AAwBD;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAchF"}
+{"version":3,"file":"model-detection.d.ts","sourceRoot":"","sources":["../src/model-detection.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAMH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAK9C,OAAO,EAA+I,KAAK,SAAS,EAA0B,MAAM,mBAAmB,CAAC;AACxN,YAAY,EAAE,SAAS,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAItE,MAAM,WAAW,iBAAiB;IAChC,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,mFAAmF;IACnF,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;yEACqE;IACrE,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB;AAoCD,wFAAwF;AACxF,wBAAsB,kBAAkB,CAAC,QAAQ,EAAE,WAAW,EAAE,OAAO,GAAE,iBAAsB,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC,CAMrH;AAkID,8EAA8E;AAC9E,wBAAgB,2BAA2B,CAAC,QAAQ,EAAE,WAAW,GAAG,SAAS,EAAE,GAAG,SAAS,CAG1F;AAMD,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,WAAW,GAAG,SAAS,EAAE,GAAG,SAAS,CAIlF;AAED,+EAA+E;AAC/E,wBAAsB,iBAAiB,CAAC,QAAQ,EAAE,WAAW,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,SAAS,GAAG,SAAS,CAAC,CAoBlI;AAED;;GAEG;AACH,wBAAsB,wBAAwB,CAAC,QAAQ,EAAE,WAAW,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAqC5F;AAifD;;;GAGG;AACH,wBAAsB,sBAAsB,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAqBrE;AA8ZD;;GAEG;AACH,wBAAgB,eAAe,CAAC,QAAQ,CAAC,EAAE,WAAW,GAAG,IAAI,CAQ5D;AAED;;;GAGG;AACH,wBAAsB,iBAAiB,CAAC,YAAY,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CASjF;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS,CAY1F;AAwDD;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAmBnF;AAwBD;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAchF"}

package/dist/model-detection.js

@@ -112,13 +112,22 @@ const INCOMPATIBLE_MODEL_PATTERNS = {
         /-similarity-/, // Similarity models
         /-edit-/, // Edit models
         /^chatgpt-4o-latest/, // Internal/unstable aliases
+        /image/, // Image generation (gpt-image-*, chatgpt-image-latest)
+        /audio|realtime|transcribe|tts|whisper|^gpt-live/, // Speech and live-voice models
+        /^sora/, // Video generation
+        /-search-preview|-search-api/, // Search-only endpoints
+        /deep-research/, // Background research agents, not chat
+        /computer-use/, // Requires the dedicated Computer Use tool contract
     ],
     google: [
         /^embedding/, // Embedding models
         /^text-embedding/, // Text embedding
         /^aqa/, // Attributed QA (not chat)
         /embedding$/, // Any model ending in embedding
+        /embedding/, // gemini-embedding-*
         /computer-use/i, // Requires the dedicated Computer Use tool contract
+        /robotics/, // Embodied-reasoning models
+        /-live|-tts|transcribe|translate|native-audio|-image/, // Live, speech, and image modalities
     ],
     groq: [
         /^whisper/, // Speech-to-text
@@ -373,13 +382,13 @@ async function getAnthropicModels(options = {}) {
         const models = await modelPages(`${(config.getBaseUrl('anthropic') || 'https://api.anthropic.com').replace(/\/v1\/?$/, '').replace(/\/$/, '')}/v1/models`, 'anthropic', { 'x-api-key': apiKey, 'anthropic-version': '2023-06-01' });
         return models
             .filter(model => model.id.startsWith('claude'))
+            .sort((a, b) => releaseOrder(Date.parse(a.created_at ?? ''), Date.parse(b.created_at ?? ''), a.id, b.id)) // Newest first
             .map(model => ({
             id: model.id,
             name: model.display_name || formatModelName(model.id),
             description: getAnthropicModelDescription(model.id),
             ...anthropicMetadata(model),
-        }))
-            .sort((a, b) => b.id.localeCompare(a.id)); // Newest first
+        }));
     }
     catch (error) {
         // Emergency fallback when the API is unreachable. Keep these as the current
@@ -388,8 +397,8 @@ async function getAnthropicModels(options = {}) {
             throw error;
         logModelDetectionWarning('Failed to fetch Anthropic models, using fallback list', error, options);
         return [
-            { id: 'claude-opus-4-8', name: 'Claude Opus 4.8', description: 'Most capable model', contextLength: 1000000 },
-            { id: 'claude-sonnet-4-6', name: 'Claude Sonnet 4.6', description: 'Balanced intelligence and speed', contextLength: 1000000 },
+            { id: 'claude-opus-5', name: 'Claude Opus 5', description: 'Most capable model', contextLength: 1000000 },
+            { id: 'claude-sonnet-5', name: 'Claude Sonnet 5', description: 'Balanced intelligence and speed', contextLength: 1000000 },
             { id: 'claude-haiku-4-5', name: 'Claude Haiku 4.5', description: 'Fast and affordable', contextLength: 200000 },
         ].map(model => ({ ...model, evidence: { source: 'emergency', at: new Date().toISOString() } }));
     }
@@ -435,7 +444,7 @@ async function getGoogleModels(options = {}) {
             maxOutputTokens: positiveLimit(model.outputTokenLimit),
             capabilities: { chat: stringList(model.supportedGenerationMethods)?.includes('generateContent'), thinking: capability(model.thinking) },
         }))
-            .sort((a, b) => b.id.localeCompare(a.id)); // Newest first
+            .sort((a, b) => geminiOrder(a.id, b.id)); // Newest first
     }
     catch (error) {
         // Fallback to known models if API fails
@@ -451,6 +460,16 @@ async function getGoogleModels(options = {}) {
         ].map(model => ({ ...model, evidence: { source: 'emergency', at: new Date().toISOString() } }));
     }
 }
+/**
+ * Gemini ids carry the generation in the name and the API reports no release
+ * date, so order by version (3.8 before 3.1 before 2.5), then pro before flash
+ * before flash-lite, then the shortest id. Unversioned rolling aliases sort last.
+ */
+function geminiOrder(aId, bId) {
+    const version = (id) => { const m = /^gemini-(\d+(?:\.\d+)?)/.exec(id); return m ? Number(m[1]) : -1; };
+    const tier = (id) => id.includes('-pro') ? 0 : id.includes('flash-lite') ? 2 : id.includes('flash') ? 1 : 3;
+    return version(bId) - version(aId) || tier(aId) - tier(bId) || aId.length - bId.length || aId.localeCompare(bId);
+}
 /**
  * Get OpenAI models
  */
@@ -461,19 +480,33 @@ async function getOpenAIModels() {
     const client = new OpenAI({ apiKey, baseURL: config.getBaseUrl('openai'), ...discoveryTransportOptions() });
     const response = await client.models.list();
     // Filter for chat-compatible models (GPT and reasoning models)
+    const family = (id) => id.replace(/-\d{4}-\d{2}-\d{2}$/, '');
+    const familyCreated = new Map();
+    for (const model of response.data)
+        familyCreated.set(family(model.id), Math.max(familyCreated.get(family(model.id)) ?? -Infinity, model.created * 1000));
     return response.data
         .filter(model => isCompatibleModel(model.id, 'openai') && (model.id.includes('gpt') ||
         model.id.startsWith('o1') ||
         model.id.startsWith('o3') ||
         model.id.startsWith('o4') ||
         model.id.startsWith('gpt-5')))
+        .sort((a, b) => releaseOrder(familyCreated.get(family(a.id)), familyCreated.get(family(b.id)), a.id, b.id)) // Newest first
         .map(model => ({
         id: model.id,
         name: model.id,
         description: getOpenAIModelDescription(model.id),
         ...compatibleMetadata(model),
-    }))
-        .sort((a, b) => a.name.localeCompare(b.name));
+    }));
+}
+/**
+ * Newest release first; within a release family, the short alias precedes its
+ * dated snapshot (gpt-5.5 before gpt-5.5-2026-04-23). Unknown dates sort last.
+ */
+function releaseOrder(aCreated, bCreated, aId, bId) {
+    const a = Number.isFinite(aCreated) ? aCreated : -Infinity, b = Number.isFinite(bCreated) ? bCreated : -Infinity;
+    if (a !== b)
+        return b - a;
+    return aId.length - bId.length || aId.localeCompare(bId);
 }
 /**
  * Get OpenRouter models