@trazum/core 1.81.0 → 1.83.0

package/dist/tokenizer.js

@@ -2,20 +2,22 @@
  * Dependency-free token estimator.
  *
  * This is NOT a real tokenizer: it is a heuristic calibrated per character
- * class. It is built to keep the typical error on ordinary text
- * (English/Spanish, markdown, code) inside ±10%, which is plenty for comparing
- * two versions of the same prompt — but do NOT bill anyone from it.
+ * class, built for comparing two versions of the same prompt — but do NOT bill
+ * anyone from it.
  *
- * **That band is a design target that has not been measured.** It is printed on
- * every report and every dollar figure descends from it, and until
- * `scripts/measure-token-band.mjs` has been run against the official counting
- * endpoint, nothing in this repository establishes that it holds. It is stated
- * as one number for all text, which is a further assumption: the branches below
- * treat CJK, digits and punctuation quite differently from words, and there is
- * no reason those should land on the same accuracy.
+ * **Its accuracy is not one number, and the years it was written as one were
+ * the mistake.** The branches below treat CJK, digits and punctuation quite
+ * differently from words, and there was never a reason those should land on the
+ * same accuracy. Measured over 47 samples against the official counting
+ * endpoint they do not: the worst error is 3.2% on CJK, 5.6% on Latin prose,
+ * 25.1% on code and quoting, and 32.5% on a digit-dominant table. `band.ts`
+ * holds the bands those measurements earn and `bandFor(text)` is what a caller
+ * should print; the constant below is only the widest of them, for callers that
+ * have no text in hand.
  *
- * `test/token-band.test.js` asserts the band per text type as soon as the ground
- * truth exists. Until then it says so rather than passing quietly.
+ * `test/token-band.test.js` holds every sample against the band `bandFor` gives
+ * it, and a sample edited since it was measured fails rather than passing
+ * quietly.
  *
  * For exact numbers use `countTokensAnthropic` (the official token-counting
  * endpoint, which is free) or pass your own `TokenCounter`.
@@ -23,52 +25,46 @@
 import { detectTextLanguage } from './language.js';
 import { SAFE_FETCH_INIT, checkedEndpoint } from './net.js';
 /**
- * The error band this estimator is published under, as a percentage.
+ * The widest band this estimator is published under, as a percentage.
  *
- * **Measured, not chosen, and it has moved three times.** It was `15` for eight
- * releases as a design target nobody had checked; the first measurement found two
- * of eight samples outside it and it went to `25`; fixing the digit divisor and
- * calibrating per language brought it back to `15`. This is the fourth value and
- * the first one that is comfortably above what the corpus actually shows.
+ * **A history worth keeping, because each value was believed at the time.** It
+ * was `15` for eight releases as a design target nobody had checked; the first
+ * measurement found two of eight samples outside it and it went to `25`; fixing
+ * the digit divisor and calibrating per language brought it back to `15`, and
+ * splitting kana from han — Japanese had been +11.2% and Chinese −3.2% under one
+ * rule — brought it to `10`. Four values, each an improvement, and all four
+ * wrong in the same way.
  *
- * ```
- * worst measured error   6.4%   (code-heavy, which nothing is fitted to)
- * published band        10%
- * ```
+ * **The corpus they were measured on was the corpus they were fitted to.**
+ * Twenty-one samples held thirteen files of Latin prose and exactly one each of
+ * code, numeric and punctuation, and those single files were where the constants
+ * came from. The worst error it could show was 6.4%, and 10 looked like a
+ * comfortable margin over it. Neither figure was about the estimator.
  *
- * **The margin is deliberate and it is not slack.** 6.4 rounded up is 7, and
- * publishing 7 would be a tighter claim than twenty-one samples across six text
- * types can support: the corpus has no Korean, no Arabic, no Cyrillic prose, no
- * mixed-script document, and a seventh text type could easily land at eight. A
- * band that becomes false the first time somebody measures something new is the
- * exact fault this whole exercise was fixing. Overstating the uncertainty is the
- * safe direction for a tool that reports money.
+ * **It is no longer one number, and this one is the widest.** A corpus of
+ * thirteen prose files and one each of code, numeric and punctuation put the
+ * band at 10, and those single files were the set the constants had been fitted
+ * to. Measured on forty-seven, the same estimator is 6% out on prose and 33%
+ * out on a CSV ledger. `bandFor` in `band.ts` is what a caller that has the
+ * text should use.
  *
- * What earned the drop from 15 was **splitting kana from han**. Every CJK
- * character was charged one token, which put Japanese at +11.2% — the worst error
- * anywhere in the corpus — while Chinese sat at −3.2% under the same rule. Kana
- * measure 0.75 tokens per character and han 1.05, and that pair takes the two
- * samples to −1.5% and +1.3%. See `KANA_TOKENS_PER_CHAR`.
- *
- * **Which samples the band rests on matters more than the number.** Eight of the
- * twenty-one had a constant fitted to them — seven Latin divisors and the digit
- * divisor — so their residuals are optimistic by construction. The two worst
- * errors in the corpus, `code-heavy` at 6.4% and `punctuation-heavy` at 5.7%, are
- * fitted to nothing at all, and they are what sets this figure.
- *
- * Exported so every report, README and tool description reads the same number. It
- * was a literal in twenty-four files before this, with the only machine-readable
- * copy in a test, and `token-band.test.js` now fails any file that states a
- * different one.
+ * This stays for the callers that do not have it — a figure covering the whole
+ * catalogue of text, which can only be the worst of them. Widening it from 10
+ * to 33 makes every claim that reads it true where it had been false, at the
+ * cost of understating the estimator on prose. That trade is deliberate: a
+ * caller with no text cannot know which it is holding, and there is only one
+ * safe direction to guess in.
  */
-export const ESTIMATE_ERROR_BAND_PCT = 10;
+export const ESTIMATE_ERROR_BAND_PCT = 33;
 /**
  * Whose tokenizer that band was measured against.
  *
  * The number above is not a property of the estimator; it is a property of the
- * estimator **against Claude**. Twenty-one samples, one counting endpoint, one
- * family. Trazum prices seven, and until somebody runs the harness against the
- * others nobody knows what the error is on a GPT or a Gemini prompt.
+ * estimator **against Claude**. Forty-seven samples, one counting endpoint, one
+ * family. Trazum prices seven, and the two that have since been run are far
+ * outside anything published here: DeepSeek 94.5% at worst, Mistral 103.1%. On
+ * a GPT or a Gemini prompt nobody has measured it at all, and
+ * `measuredForeignError` answers null rather than the nearest number.
  *
  * Exported as a name rather than left implicit in a comment because the band
  * had already leaked out of its domain in three places: an advisory that told a
@@ -164,6 +160,33 @@ const DIVISOR_BY_LANGUAGE = {
  */
 const KANA_TOKENS_PER_CHAR = 0.75;
 const HAN_TOKENS_PER_CHAR = 1.05;
+/**
+ * Hangul, measured at last.
+ *
+ * The comment above used to end *"Hangul keeps the old cost of 1, because
+ * nothing here measures Korean. Guessing it from Japanese would be inventing a
+ * figure."* That was right, and it stayed right for exactly as long as nobody
+ * measured Korean. `cjk-korean.txt` now does: at 1 token per character the
+ * estimate came out **20.0% under** — 232 against 290 — and 1.20 takes it to
+ * -10.0%.
+ *
+ * **1.20 was the one-sample answer and it was wrong by ten points.** A second
+ * Korean sample in a different register — a deployment review against support
+ * copy — put both at -10.6% and -10.0% under it, and solving the constant on
+ * the two together lands on 1.35, where both come out at 0.0%.
+ *
+ * Two independent texts agreeing to within four tenths of a point across the
+ * whole search is what makes this a property of Hangul rather than a fit to a
+ * file. Their residuals move in lockstep at every candidate value: -10.6/-10.0
+ * at 1.20, -3.5/-3.1 at 1.30, 3.2/3.4 at 1.40. One sample cannot show that and
+ * two can, which is the entire argument for measuring more of the thin classes
+ * rather than tuning harder on the thin ones.
+ *
+ * Still in-sample: the honest test is a third Korean prompt, and the corpus
+ * grows one at a time.
+ */
+const HANGUL_TOKENS_PER_CHAR = 1.35;
+const HANGUL = /[가-힯]/;
 /**
  * What a prompt gets when the language could not be told.
  *
@@ -233,7 +256,11 @@ export function estimateTokens(text) {
              * where the loop happens to break, not of what the text costs.
              */
             while (i < chars.length && CJK.test(chars[i])) {
-                cjkTokens += KANA.test(chars[i]) ? KANA_TOKENS_PER_CHAR : HAN_TOKENS_PER_CHAR;
+                cjkTokens += KANA.test(chars[i])
+                    ? KANA_TOKENS_PER_CHAR
+                    : HANGUL.test(chars[i])
+                        ? HANGUL_TOKENS_PER_CHAR
+                        : HAN_TOKENS_PER_CHAR;
                 i++;
             }
             continue;
@@ -295,7 +322,29 @@ export function estimateTokens(text) {
             i++;
         }
         else {
-            total += Math.ceil(n / 2);
+            /**
+             * One token per symbol, not one per two.
+             *
+             * Two was the shipped value and every symbol-dense sample in the corpus
+             * undercounted under it, in the same direction, by amounts that grow with
+             * density: punctuation-heavy -5.7%, code-heavy -6.4%,
+             * punctuation-markup -11.4%, code-sql -25.6%, code-shell -29.8%. Five
+             * samples agreeing on a direction is a shape, not a fit — a merge table
+             * covers `, ` and `. ` and covers `${`, `"$`, `--` and `&#8209;` far less
+             * well, and shell and SQL are made of the second kind.
+             *
+             * Searched over the whole corpus rather than the class it helps, so a
+             * value that fixed code by wrecking prose could not look like a win: at
+             * 1.0 the samples outside the published band drop from five to three and
+             * the mean error from 6.6% to 5.1%, with no sample moved more than a
+             * point in the wrong direction.
+             *
+             * The search wanted to go below 1.0 and was not allowed to. Below one is
+             * more than a token per symbol, which may well be true of SQL — code-sql
+             * is still 24.9% under — but it is a claim about a class this corpus has
+             * two samples of, and two samples do not earn a constant.
+             */
+            total += Math.ceil(n / 1);
         }
     }
     // Rounded once, over the whole document, rather than per run — see the CJK branch.

package/dist/tokenizer.js.map

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

package/dist/types.d.ts

@@ -48,7 +48,7 @@ export interface RuleResult {
 /** Severity of an advisory: the higher it is, the more money is usually at stake. */
 export type AdvisorySeverity = 'info' | 'opportunity' | 'warning';
 /** Every advisory the core can emit. */
-export type AdvisoryId = 'context-overflow' | 'context-near-limit' | 'prompt-caching' | 'prompt-caching-not-worth-it' | 'below-cache-minimum' | 'cache-prefix-reorder' | 'batch-api' | 'model-downgrade' | 'output-dominated' | 'promo-pricing' | 'contradictory-instructions' | 'redundant-examples' | 'restated-output-format' | 'movable-output-schema';
+export type AdvisoryId = 'context-overflow' | 'context-near-limit' | 'prompt-caching' | 'prompt-caching-not-worth-it' | 'below-cache-minimum' | 'cache-prefix-reorder' | 'batch-api' | 'model-downgrade' | 'tier-signals-conflict' | 'output-dominated' | 'promo-pricing' | 'model-retired' | 'contradictory-instructions' | 'redundant-examples' | 'restated-output-format' | 'movable-output-schema';
 /** A recommendation that does NOT modify the prompt, only informs. */
 export interface Advisory {
     id: AdvisoryId;
@@ -125,6 +125,64 @@ export type CachingMode =
  * what it says.
  */
 export type Capability = 'small' | 'mid' | 'large' | 'frontier' | 'unknown';
+/**
+ * What makes a conditional rate apply, as data a machine can evaluate.
+ *
+ * Deliberately a closed union rather than a predicate function. A catalogue
+ * entry is reviewed the way a price is reviewed, and a reviewer can check
+ * "peak is 01:00-04:00 and 06:00-10:00 UTC on weekdays" against a provider's
+ * page; nobody can review a closure. It also means the condition survives
+ * `JSON.stringify`, which matters because the catalogue can be overlaid from a
+ * file.
+ */
+export type TierCondition = 
+/**
+ * The prompt is larger than `tokens` input tokens.
+ *
+ * Decidable only where the token count is known, which is most of the places
+ * that price a specific call and none of the places that merely rank models.
+ * `effectivePricing` says which happened rather than guessing.
+ */
+{
+    kind: 'input-tokens-above';
+    tokens: number;
+}
+/**
+ * The call falls inside one of `hours` in UTC, optionally on weekdays only.
+ *
+ * Decidable everywhere, because every caller already passes the date it is
+ * pricing for. `hours` lists the hour each window *starts*, so 01:00-04:00
+ * is `[1, 2, 3]` and not `[1, 4]`: an endpoint convention is the kind of
+ * thing two readers disagree about silently.
+ */
+ | {
+    kind: 'utc-hours';
+    hours: number[];
+    weekdaysOnly: boolean;
+};
+/**
+ * A rate that applies when its condition holds.
+ *
+ * Deliberately carries no multipliers of its own, and the first draft did. The
+ * reasoning for adding them was that DeepSeek halves the cache-hit price at
+ * off-peak along with everything else, so a cache read priced off the base
+ * would be wrong about the money — which is true of the *price* and false of
+ * the *ratio*: $0.007 against $0.22 and $0.014 against $0.44 are the same
+ * 3.18% to the last digit, on both models. Multiplying a tier's own input rate
+ * by the model's multiplier already gives the right answer.
+ *
+ * It was removed because the guard written to prove it mattered could not: with
+ * the tier multiplier equal to the base one, dropping it changed nothing and
+ * the test passed either way. An option nothing can distinguish from its
+ * absence is a claim nobody checks, which is worse than not having it.
+ */
+export interface PricingTier {
+    /** Short, stable, and printed: a reader has to be able to see which applied. */
+    id: string;
+    when: TierCondition;
+    inputPerMTok: number;
+    outputPerMTok: number;
+}
 export interface ModelPricing {
     id: string;
     displayName: string;
@@ -156,6 +214,32 @@ export interface ModelPricing {
      * buy is advice that wastes their time.
      */
     recommendable?: boolean;
+    /**
+     * Set when the provider refused a real request for this id.
+     *
+     * A retired model keeps its price and loses its future. Both halves matter:
+     * a log full of `deepseek-v3` calls records money that was genuinely spent,
+     * so deleting the row would make somebody's own history unpriceable — and a
+     * *new* call on that id will not happen at all, so quoting it as an option is
+     * a number for a question nobody can ask.
+     *
+     * `on` is the day `scripts/check-model-availability.mjs` was refused, and
+     * `because` is the provider's own sentence, quoted rather than paraphrased.
+     * Neither is a judgement, and neither implies anything about what the
+     * replacement costs: that is a price, and a price comes off the provider's
+     * own page or not at all.
+     *
+     * A retired model is never recommended, never offered as a cheaper
+     * alternative and never chosen as a tier's representative, in the same places
+     * `recommendable: false` is honoured — this is a stronger statement than that
+     * one and must not be weaker in effect.
+     */
+    retired?: {
+        /** ISO date the refusal was recorded. */
+        on: string;
+        /** What the provider answered, in the provider's words. */
+        because: string;
+    };
     /** Capability, on a vendor-neutral scale. */
     capability: Capability;
     /**
@@ -171,6 +255,29 @@ export interface ModelPricing {
         /** ISO date (inclusive) the promotional price applies until. */
         until: string;
     };
+    /**
+     * Rates that apply only under a stated condition.
+     *
+     * The catalogue held one input price and one output price per model until a
+     * real credential was pointed at the providers and two of them turned out not
+     * to charge that way:
+     *
+     * - **DeepSeek V4 bills by the clock.** Peak is 01:00-04:00 and 06:00-10:00
+     *   UTC, Monday to Friday, and off-peak is exactly half. That is 35 hours of
+     *   168, so the common case is the cheap one and a single number would have
+     *   been wrong by 2x in whichever direction it was chosen.
+     * - **Gemini 3.1 Pro bills by prompt size**, $2/$12 up to 200k input tokens
+     *   and $4/$18 above it.
+     *
+     * Both are *conditions*, so both are written as data rather than as prose in
+     * `notes`: a note is something a reader has to apply by hand, and this
+     * product exists to stop people doing arithmetic by hand.
+     *
+     * The base `inputPerMTok` and `outputPerMTok` stay the rate that applies when
+     * no condition matches, which keeps every model that has no tiers unchanged
+     * and keeps this field optional in effect as well as in the type.
+     */
+    tiers?: PricingTier[];
     /**
      * Other ids that bill at exactly this rate.
      *

package/dist/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}

package/dist/verdict-bridge.d.ts

@@ -0,0 +1,113 @@
+/**
+ * Reading a dropped `route --json` verdict, so quality can stand beside cost.
+ *
+ * The bill is arithmetic: every figure in it comes from records already on
+ * disk, and it can say exactly what a cheaper model would have saved. It can
+ * say nothing at all about whether that model still does the job. That answer
+ * costs provider calls and a credential, which is why `trazum route` exists
+ * and why no surface that only reads a log will ever produce it.
+ *
+ * This is the bridge between the two, and it is deliberately one-directional:
+ * the measurement is made where the credential is, written out as the
+ * `routing-measurement` contract, and read back here by a pure function that
+ * touches no network and holds no key. A reader who has run `route` once can
+ * carry the verdict to any surface that prices the same workload.
+ *
+ * It was not possible to write until the document was worth reading. Before
+ * the JSON-text sweep, `route --json` printed the whole `EvalReport` — every
+ * case input and three model answers per case — so a bridge would have been a
+ * feature for carrying prompt text into a browser. The document carries the
+ * measurement and nothing else now, and `conform` is what says so rather than
+ * this file's own reading: the contract validates, the bridge only maps.
+ */
+import type { EvalVerdict } from './evaluate.js';
+/** What a dropped routing measurement says, mapped onto what a bill can match. */
+export interface DroppedVerdict {
+    /** The workload the measurement was made on, or null when it was unlabelled. */
+    label: string | null;
+    /**
+     * The model those calls go to today, from the bill's own slice.
+     *
+     * Not the model that answered. `route` builds its baseline provider from
+     * the environment, so the model in the measurement is whatever
+     * `TRAZUM_LLM_MODEL` names, and it is only the log's model when the reader
+     * configured it that way. Pairing on it matched nothing on a real run
+     * against an OpenAI-compatible endpoint — `evaluation.model` said
+     * `stub-strong` while the log said `claude-opus-5` — and the bill would
+     * have shown no verdict at all with no explanation.
+     */
+    model: string;
+    /**
+     * The model that actually answered, when it is not the one the log records.
+     *
+     * Null when they agree, which is the ordinary case. Not null is worth
+     * saying out loud rather than smoothing over: a verdict measured on a
+     * stand-in is a weaker claim about this workload than one measured on the
+     * model the workload actually uses, and only this field can tell the
+     * difference.
+     */
+    measuredOn: string | null;
+    /** The model measured against it. */
+    candidateModel: string;
+    verdict: EvalVerdict;
+    /** The model's agreement with itself. The yardstick the other rate is read against. */
+    selfAgreement: number;
+    /** Agreement between the two models, same prompt on both sides. */
+    crossAgreement: number;
+    /** Cases the measurement covered, so a two-case verdict cannot pose as a hundred. */
+    cases: number;
+    /** Calls it cost to reach. */
+    callsMade: number;
+    /**
+     * What the measurement's own bill priced the route at, when the document
+     * carried it. Null rather than zero when it did not: a saving nobody
+     * measured is not a saving of nothing.
+     */
+    savingUsd: number | null;
+}
+/**
+ * What the bridge did with a file.
+ *
+ * `null` is not a failure: it means the file is not a routing measurement at
+ * all, and the caller should go on treating it as whatever else it was. A
+ * refusal is the other case — it looked like one and could not be read — and
+ * it names what is missing, because a refusal with nothing after it is
+ * indistinguishable from a bug.
+ */
+export type BridgeReading = {
+    kind: 'verdict';
+    verdict: DroppedVerdict;
+} | {
+    kind: 'refusal';
+    because: string;
+};
+/**
+ * Reads a dropped `trazum route --json` document.
+ *
+ * Returns null when the text is something else entirely. Validation is
+ * `conform`'s, against the published `routing-measurement` contract, so this
+ * function cannot drift from the schema a connector author builds against —
+ * and a document that fails carries the contract's own sentences back to the
+ * reader rather than a second opinion written here.
+ */
+export declare function readDroppedVerdict(text: string): BridgeReading | null;
+/**
+ * Whether a verdict describes the route a given slice of the bill is offering.
+ *
+ * Both halves must agree or the pairing is a lie: the same workload, the same
+ * model it goes to now, and the same candidate. A verdict measured on `chat`
+ * shown against `summarise`'s saving would be the exact fault this repository
+ * keeps finding in itself — a number describing something other than what was
+ * measured — and matching on the model alone would produce it on any log with
+ * two workloads on one model.
+ */
+export declare function verdictMatchesSlice(verdict: DroppedVerdict, slice: {
+    label: string;
+    model: string;
+    route: {
+        candidate: {
+            id: string;
+        };
+    } | null;
+}): boolean;
+//# sourceMappingURL=verdict-bridge.d.ts.map

package/dist/verdict-bridge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"verdict-bridge.d.ts","sourceRoot":"","sources":["../src/verdict-bridge.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAGH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAGjD,kFAAkF;AAClF,MAAM,WAAW,cAAc;IAC7B,gFAAgF;IAChF,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB;;;;;;;;;;OAUG;IACH,KAAK,EAAE,MAAM,CAAC;IACd;;;;;;;;OAQG;IACH,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,qCAAqC;IACrC,cAAc,EAAE,MAAM,CAAC;IACvB,OAAO,EAAE,WAAW,CAAC;IACrB,uFAAuF;IACvF,aAAa,EAAE,MAAM,CAAC;IACtB,mEAAmE;IACnE,cAAc,EAAE,MAAM,CAAC;IACvB,qFAAqF;IACrF,KAAK,EAAE,MAAM,CAAC;IACd,8BAA8B;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB;;;;OAIG;IACH,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1B;AAED;;;;;;;;GAQG;AACH,MAAM,MAAM,aAAa,GACrB;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,OAAO,EAAE,cAAc,CAAA;CAAE,GAC5C;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC;AAkBzC;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,aAAa,GAAG,IAAI,CAkErE;AAED;;;;;;;;;GASG;AACH,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,cAAc,EACvB,KAAK,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE;QAAE,SAAS,EAAE;YAAE,EAAE,EAAE,MAAM,CAAA;SAAE,CAAA;KAAE,GAAG,IAAI,CAAA;CAAE,GACnF,OAAO,CAQT"}

package/dist/verdict-bridge.js

@@ -0,0 +1,127 @@
+/**
+ * Reading a dropped `route --json` verdict, so quality can stand beside cost.
+ *
+ * The bill is arithmetic: every figure in it comes from records already on
+ * disk, and it can say exactly what a cheaper model would have saved. It can
+ * say nothing at all about whether that model still does the job. That answer
+ * costs provider calls and a credential, which is why `trazum route` exists
+ * and why no surface that only reads a log will ever produce it.
+ *
+ * This is the bridge between the two, and it is deliberately one-directional:
+ * the measurement is made where the credential is, written out as the
+ * `routing-measurement` contract, and read back here by a pure function that
+ * touches no network and holds no key. A reader who has run `route` once can
+ * carry the verdict to any surface that prices the same workload.
+ *
+ * It was not possible to write until the document was worth reading. Before
+ * the JSON-text sweep, `route --json` printed the whole `EvalReport` — every
+ * case input and three model answers per case — so a bridge would have been a
+ * feature for carrying prompt text into a browser. The document carries the
+ * measurement and nothing else now, and `conform` is what says so rather than
+ * this file's own reading: the contract validates, the bridge only maps.
+ */
+import { conform } from './conform.js';
+import { UNLABELLED } from './usage.js';
+const isObject = (value) => typeof value === 'object' && value !== null && !Array.isArray(value);
+/**
+ * Whether this file is even claiming to be a routing measurement.
+ *
+ * Shape only, and deliberately narrow: an `evaluation` object carrying a
+ * `verdict`. Anything looser would swallow a usage log or a profile and
+ * refuse it in this file's words instead of letting the caller price it.
+ */
+function claimsToBeOne(parsed) {
+    if (!isObject(parsed))
+        return false;
+    const evaluation = parsed.evaluation;
+    return isObject(evaluation) && typeof evaluation.verdict === 'string';
+}
+/**
+ * Reads a dropped `trazum route --json` document.
+ *
+ * Returns null when the text is something else entirely. Validation is
+ * `conform`'s, against the published `routing-measurement` contract, so this
+ * function cannot drift from the schema a connector author builds against —
+ * and a document that fails carries the contract's own sentences back to the
+ * reader rather than a second opinion written here.
+ */
+export function readDroppedVerdict(text) {
+    let parsed;
+    try {
+        parsed = JSON.parse(text);
+    }
+    catch {
+        return null;
+    }
+    if (!claimsToBeOne(parsed))
+        return null;
+    const report = conform(text, { contract: 'routing-measurement' });
+    if (!report.conforms) {
+        const detail = report.problems.length > 0
+            ? report.problems.map((problem) => `${problem.at}: ${problem.detail}`).join('; ')
+            : (report.because ?? 'it does not match the routing-measurement contract');
+        return { kind: 'refusal', because: detail };
+    }
+    const document = parsed;
+    const slice = isObject(document.slice) ? document.slice : {};
+    const evaluation = document.evaluation;
+    /**
+     * Every field below is read defensively even though `conform` has passed,
+     * because the contract requires `slice` and `evaluation` to be objects and
+     * says nothing about what is inside them. A document from a future version
+     * with a thinner slice is a document this reads what it can from, not one
+     * it crashes on.
+     */
+    const answered = typeof evaluation.model === 'string' ? evaluation.model : null;
+    // The slice's model first: that is the fact the bill can be matched against.
+    const model = typeof slice.model === 'string' ? slice.model : answered;
+    const candidateModel = typeof evaluation.candidateModel === 'string' ? evaluation.candidateModel : null;
+    const verdict = typeof evaluation.verdict === 'string' ? evaluation.verdict : null;
+    if (model === null || candidateModel === null || verdict === null) {
+        return {
+            kind: 'refusal',
+            because: 'the evaluation names no model, candidate model or verdict, so there is nothing to set beside a bill',
+        };
+    }
+    const number = (value) => (typeof value === 'number' ? value : 0);
+    const route = isObject(slice.route) ? slice.route : null;
+    const rawLabel = typeof slice.label === 'string' ? slice.label : null;
+    return {
+        kind: 'verdict',
+        verdict: {
+            // `UNLABELLED` is the profile's own sentinel for calls that carry no
+            // label. It travels through the document as that sentinel and comes
+            // back as null here, so the bridge speaks the bill's language rather
+            // than leaking an internal marker into a caption.
+            label: rawLabel === null || rawLabel === UNLABELLED ? null : rawLabel,
+            model,
+            measuredOn: answered !== null && answered !== model ? answered : null,
+            candidateModel,
+            verdict,
+            selfAgreement: number(evaluation.selfAgreement),
+            crossAgreement: number(evaluation.crossAgreement),
+            cases: Array.isArray(evaluation.cases) ? evaluation.cases.length : 0,
+            callsMade: number(evaluation.callsMade),
+            savingUsd: route !== null && typeof route.savingUsd === 'number' ? route.savingUsd : null,
+        },
+    };
+}
+/**
+ * Whether a verdict describes the route a given slice of the bill is offering.
+ *
+ * Both halves must agree or the pairing is a lie: the same workload, the same
+ * model it goes to now, and the same candidate. A verdict measured on `chat`
+ * shown against `summarise`'s saving would be the exact fault this repository
+ * keeps finding in itself — a number describing something other than what was
+ * measured — and matching on the model alone would produce it on any log with
+ * two workloads on one model.
+ */
+export function verdictMatchesSlice(verdict, slice) {
+    if (slice.route === null)
+        return false;
+    const sliceLabel = slice.label === UNLABELLED ? null : slice.label;
+    return (sliceLabel === verdict.label &&
+        slice.model === verdict.model &&
+        slice.route.candidate.id === verdict.candidateModel);
+}
+//# sourceMappingURL=verdict-bridge.js.map