@trazum/core 1.8.0

package/dist/pricing.js

@@ -0,0 +1,400 @@
+/**
+ * Model and pricing catalogue (USD per million tokens).
+ *
+ * Source: official Claude API documentation. Prices change: check
+ * `PRICING_LAST_REVIEWED` and update this file before making budget decisions.
+ * Amazon Bedrock and Vertex AI pricing is set by each partner and is NOT the
+ * pricing in this table.
+ */
+export const PRICING_LAST_REVIEWED = '2026-06-24';
+/** Cost multipliers relative to the input price. */
+/**
+ * The defaults, which are Anthropic's numbers.
+ *
+ * Still exported and still correct for every Anthropic model, but no longer the
+ * whole story: a model can override any of these through `multipliers`, and
+ * anything computing a cost should go through `multipliersFor` rather than
+ * reading these directly. A cache read is ~10% of input on Anthropic and ~50%
+ * on OpenAI, and using one number for both invents a saving.
+ */
+export const COST_MULTIPLIERS = {
+    /** Cache write with a 5-minute TTL. */
+    cacheWrite5m: 1.25,
+    /** Cache write with a 1-hour TTL. */
+    cacheWrite1h: 2.0,
+    /** Cache read: ~10% of the input price. */
+    cacheRead: 0.1,
+    /** Batch API: 50% discount on input and output. */
+    batch: 0.5,
+};
+/**
+ * The multipliers that apply to one model, defaults filled in.
+ *
+ * `batch` stays `null` when the provider has no batch API, which is different
+ * from "unspecified": the first should stop the advisory firing, the second
+ * should fall back to the default.
+ */
+export function multipliersFor(model) {
+    const m = model.multipliers ?? {};
+    return {
+        cacheWrite5m: m.cacheWrite5m ?? COST_MULTIPLIERS.cacheWrite5m,
+        cacheWrite1h: m.cacheWrite1h ?? COST_MULTIPLIERS.cacheWrite1h,
+        cacheRead: m.cacheRead ?? COST_MULTIPLIERS.cacheRead,
+        batch: m.batch === undefined ? COST_MULTIPLIERS.batch : m.batch,
+    };
+}
+export const MODELS = [
+    {
+        id: 'claude-fable-5',
+        provider: 'anthropic',
+        displayName: 'Claude Fable 5',
+        inputPerMTok: 10,
+        outputPerMTok: 50,
+        contextWindow: 1_000_000,
+        cacheMinTokens: 512,
+        capability: 'frontier',
+        tier: 'frontier',
+        notes: 'Highest capability. Requires 30-day data retention.',
+    },
+    {
+        id: 'claude-mythos-5',
+        provider: 'anthropic',
+        displayName: 'Claude Mythos 5',
+        recommendable: false,
+        inputPerMTok: 10,
+        outputPerMTok: 50,
+        contextWindow: 1_000_000,
+        cacheMinTokens: 512,
+        capability: 'frontier',
+        tier: 'frontier',
+        notes: 'Available only through Project Glasswing.',
+    },
+    {
+        id: 'claude-opus-5',
+        provider: 'anthropic',
+        displayName: 'Claude Opus 5',
+        inputPerMTok: 5,
+        outputPerMTok: 25,
+        contextWindow: 1_000_000,
+        cacheMinTokens: 512,
+        capability: 'large',
+        tier: 'opus',
+        notes: '512-token cache minimum: caches prompts that would miss on Opus 4.6.',
+    },
+    {
+        id: 'claude-opus-4-8',
+        provider: 'anthropic',
+        displayName: 'Claude Opus 4.8',
+        inputPerMTok: 5,
+        outputPerMTok: 25,
+        contextWindow: 1_000_000,
+        cacheMinTokens: 1024,
+        capability: 'large',
+        tier: 'opus',
+    },
+    {
+        id: 'claude-opus-4-7',
+        provider: 'anthropic',
+        displayName: 'Claude Opus 4.7',
+        inputPerMTok: 5,
+        outputPerMTok: 25,
+        contextWindow: 1_000_000,
+        cacheMinTokens: 2048,
+        capability: 'large',
+        tier: 'opus',
+    },
+    {
+        id: 'claude-opus-4-6',
+        provider: 'anthropic',
+        displayName: 'Claude Opus 4.6',
+        inputPerMTok: 5,
+        outputPerMTok: 25,
+        contextWindow: 1_000_000,
+        cacheMinTokens: 4096,
+        capability: 'large',
+        tier: 'opus',
+    },
+    {
+        id: 'claude-sonnet-5',
+        provider: 'anthropic',
+        displayName: 'Claude Sonnet 5',
+        inputPerMTok: 3,
+        outputPerMTok: 15,
+        contextWindow: 1_000_000,
+        cacheMinTokens: 1024,
+        capability: 'mid',
+        tier: 'sonnet',
+        promo: { inputPerMTok: 2, outputPerMTok: 10, until: '2026-08-31' },
+        notes: 'Introductory pricing of 2/10 until 2026-08-31; 3/15 afterwards.',
+    },
+    {
+        id: 'claude-sonnet-4-6',
+        provider: 'anthropic',
+        displayName: 'Claude Sonnet 4.6',
+        inputPerMTok: 3,
+        outputPerMTok: 15,
+        contextWindow: 1_000_000,
+        cacheMinTokens: 1024,
+        capability: 'mid',
+        tier: 'sonnet',
+    },
+    {
+        id: 'claude-haiku-4-5',
+        provider: 'anthropic',
+        displayName: 'Claude Haiku 4.5',
+        inputPerMTok: 1,
+        outputPerMTok: 5,
+        contextWindow: 200_000,
+        cacheMinTokens: 4096,
+        capability: 'small',
+        tier: 'haiku',
+        notes: '200K context window and a 64K output cap, smaller than the rest.',
+    },
+    // ------------------------------------------------------------------------
+    // OpenAI
+    //
+    // Caching is AUTOMATIC above 1,024 tokens — there is no cache_control to set,
+    // and a cached read costs about half the input price rather than a tenth. The
+    // reordering advice is identical (a prefix is a prefix), the marker advice is
+    // not, which is why `caching` and `multipliers` exist at all.
+    // ------------------------------------------------------------------------
+    {
+        id: 'gpt-5',
+        provider: 'openai',
+        displayName: 'GPT-5',
+        inputPerMTok: 1.25,
+        outputPerMTok: 10,
+        contextWindow: 400_000,
+        cacheMinTokens: 1024,
+        caching: 'automatic',
+        multipliers: { cacheRead: 0.1, cacheWrite5m: 1, cacheWrite1h: 1, batch: 0.5 },
+        capability: 'frontier',
+        tier: 'frontier',
+        notes: 'Caching is automatic above 1,024 tokens; there is no cache_control to set.',
+    },
+    {
+        id: 'gpt-5-mini',
+        provider: 'openai',
+        displayName: 'GPT-5 mini',
+        inputPerMTok: 0.25,
+        outputPerMTok: 2,
+        contextWindow: 400_000,
+        cacheMinTokens: 1024,
+        caching: 'automatic',
+        multipliers: { cacheRead: 0.1, cacheWrite5m: 1, cacheWrite1h: 1, batch: 0.5 },
+        capability: 'mid',
+        tier: 'sonnet',
+    },
+    {
+        id: 'gpt-5-nano',
+        provider: 'openai',
+        displayName: 'GPT-5 nano',
+        inputPerMTok: 0.05,
+        outputPerMTok: 0.4,
+        contextWindow: 400_000,
+        cacheMinTokens: 1024,
+        caching: 'automatic',
+        multipliers: { cacheRead: 0.1, cacheWrite5m: 1, cacheWrite1h: 1, batch: 0.5 },
+        capability: 'small',
+        tier: 'haiku',
+    },
+    // ------------------------------------------------------------------------
+    // Google
+    // ------------------------------------------------------------------------
+    {
+        id: 'gemini-2.5-pro',
+        provider: 'google',
+        displayName: 'Gemini 2.5 Pro',
+        inputPerMTok: 1.25,
+        outputPerMTok: 10,
+        contextWindow: 1_048_576,
+        cacheMinTokens: 2048,
+        caching: 'explicit',
+        multipliers: { cacheRead: 0.25, cacheWrite5m: 1, cacheWrite1h: 1, batch: 0.5 },
+        capability: 'large',
+        tier: 'opus',
+        notes: 'Context caching is billed for storage per hour as well as per read.',
+    },
+    {
+        id: 'gemini-2.5-flash',
+        provider: 'google',
+        displayName: 'Gemini 2.5 Flash',
+        inputPerMTok: 0.3,
+        outputPerMTok: 2.5,
+        contextWindow: 1_048_576,
+        cacheMinTokens: 1024,
+        caching: 'explicit',
+        multipliers: { cacheRead: 0.25, cacheWrite5m: 1, cacheWrite1h: 1, batch: 0.5 },
+        capability: 'mid',
+        tier: 'sonnet',
+    },
+    // ------------------------------------------------------------------------
+    // Moonshot
+    // ------------------------------------------------------------------------
+    {
+        id: 'kimi-k2',
+        provider: 'moonshot',
+        displayName: 'Kimi K2',
+        inputPerMTok: 0.6,
+        outputPerMTok: 2.5,
+        contextWindow: 256_000,
+        cacheMinTokens: 1024,
+        caching: 'automatic',
+        multipliers: { cacheRead: 0.1, cacheWrite5m: 1, cacheWrite1h: 1, batch: null },
+        capability: 'mid',
+        tier: 'sonnet',
+        notes: 'No batch API: the batch advisory stays quiet rather than offering a discount you cannot buy.',
+    },
+    // ------------------------------------------------------------------------
+    // DeepSeek
+    // ------------------------------------------------------------------------
+    {
+        id: 'deepseek-v3',
+        provider: 'deepseek',
+        displayName: 'DeepSeek V3',
+        inputPerMTok: 0.27,
+        outputPerMTok: 1.1,
+        contextWindow: 128_000,
+        cacheMinTokens: 1024,
+        caching: 'automatic',
+        multipliers: { cacheRead: 0.1, cacheWrite5m: 1, cacheWrite1h: 1, batch: null },
+        capability: 'mid',
+        tier: 'sonnet',
+    },
+    // ------------------------------------------------------------------------
+    // xAI
+    // ------------------------------------------------------------------------
+    {
+        id: 'grok-4',
+        provider: 'xai',
+        displayName: 'Grok 4',
+        inputPerMTok: 3,
+        outputPerMTok: 15,
+        contextWindow: 256_000,
+        cacheMinTokens: 1024,
+        caching: 'automatic',
+        multipliers: { cacheRead: 0.25, cacheWrite5m: 1, cacheWrite1h: 1, batch: null },
+        capability: 'large',
+        tier: 'opus',
+    },
+    // ------------------------------------------------------------------------
+    // Mistral
+    // ------------------------------------------------------------------------
+    {
+        id: 'mistral-large-2',
+        provider: 'mistral',
+        displayName: 'Mistral Large 2',
+        inputPerMTok: 2,
+        outputPerMTok: 6,
+        contextWindow: 128_000,
+        cacheMinTokens: 0,
+        caching: 'none',
+        multipliers: { batch: 0.5 },
+        capability: 'large',
+        tier: 'opus',
+        notes: 'No prompt caching: reordering still helps readability but saves nothing here.',
+    },
+];
+export const DEFAULT_MODEL = 'claude-opus-5';
+function makeCatalogue(models, lastReviewed, overriddenModels = [], addedModels = []) {
+    return {
+        models,
+        byId: new Map(models.map((m) => [m.id, m])),
+        lastReviewed,
+        overriddenModels,
+        addedModels,
+    };
+}
+/** The prices compiled into this release. */
+export const BUNDLED_CATALOGUE = makeCatalogue(MODELS, PRICING_LAST_REVIEWED);
+/** Looks a model up in a specific catalogue. */
+export function modelFrom(catalogue, id) {
+    const model = catalogue.byId.get(id);
+    if (!model) {
+        throw new Error(`Unknown model: "${id}". Available: ${catalogue.models.map((m) => m.id).join(', ')}`);
+    }
+    return model;
+}
+/**
+ * Cheapest model of a tier within a catalogue.
+ *
+ * Compared on the **effective** price, so a model in a promotional window is
+ * ranked at what it actually costs today rather than at its list price.
+ */
+export function cheapestOfTierIn(catalogue, tier, on = new Date(), 
+/**
+ * Restrict to one provider. Omit to search the whole catalogue, which is what
+ * this did before other providers existed — kept as the default so the
+ * signature stays additive, though the advisory always passes one: switching
+ * vendor is a migration, not a cheaper model.
+ */
+provider) {
+    const candidates = catalogue.models.filter((m) => m.tier === tier &&
+        m.recommendable !== false &&
+        (provider === undefined || m.provider === provider));
+    const first = candidates[0];
+    if (!first)
+        throw new Error(`No models for tier "${tier}"`);
+    return candidates.reduce((best, m) => effectivePricing(m, on).inputPerMTok < effectivePricing(best, on).inputPerMTok ? m : best, first);
+}
+export function getModel(id) {
+    return modelFrom(BUNDLED_CATALOGUE, id);
+}
+export function listModels() {
+    return [...MODELS];
+}
+/** Effective price on a given date, applying any live promotion. */
+export function effectivePricing(model, on = new Date()) {
+    if (model.promo) {
+        const until = new Date(`${model.promo.until}T23:59:59.999Z`);
+        if (on.getTime() <= until.getTime()) {
+            return {
+                inputPerMTok: model.promo.inputPerMTok,
+                outputPerMTok: model.promo.outputPerMTok,
+                promoApplied: true,
+            };
+        }
+    }
+    return {
+        inputPerMTok: model.inputPerMTok,
+        outputPerMTok: model.outputPerMTok,
+        promoApplied: false,
+    };
+}
+/** Cheapest model of each capability tier, for recommendations. */
+export function cheapestOfTier(tier) {
+    const candidates = MODELS.filter((m) => m.tier === tier && m.recommendable !== false);
+    const first = candidates[0];
+    if (!first)
+        throw new Error(`No models for tier "${tier}"`);
+    return candidates.reduce((best, m) => (m.inputPerMTok < best.inputPerMTok ? m : best), first);
+}
+/**
+ * Whole days between a `YYYY-MM-DD` review date and now, or `null`.
+ *
+ * Every dollar figure Trazum prints descends from a price list, and the list
+ * carries the date it was checked. Printing only that date makes the reader do
+ * arithmetic against today to learn the one thing they wanted to know — whether
+ * to trust it — and a reader who is not already suspicious will not bother.
+ *
+ * `now` is a parameter for the reason `computeSavings` takes a `Date`: a function
+ * that reads the clock can only be asserted for shape.
+ *
+ * Compared at UTC midnight on both sides, so the answer does not change by one
+ * depending on what time of day the command runs. `null` for anything that is not
+ * a date — an overlay supplies this string, and a wrong one should read as
+ * unknown rather than as a confident number computed from `NaN`.
+ */
+export function reviewAgeDays(lastReviewed, now) {
+    if (!/^\d{4}-\d{2}-\d{2}$/.test(lastReviewed))
+        return null;
+    const then = Date.parse(`${lastReviewed}T00:00:00Z`);
+    if (Number.isNaN(then))
+        return null;
+    const today = Date.UTC(now.getUTCFullYear(), now.getUTCMonth(), now.getUTCDate());
+    const days = Math.round((today - then) / 86_400_000);
+    // A future date is a typo or a clock problem, not an age. Reported as unknown
+    // rather than as a negative number of days, which reads like a bug either way.
+    return days < 0 ? null : days;
+}
+//# sourceMappingURL=pricing.js.map

package/dist/pricing.js.map

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

package/dist/profile.d.ts

@@ -0,0 +1,71 @@
+import type { TokenCounter } from './types.js';
+/**
+ * What a prompt is made of, so a team can decide which one to fix first.
+ *
+ * ## Why this is not a score
+ *
+ * The obvious shape for "which prompts should we optimise?" is a number out of
+ * a hundred, and it is the wrong shape. `Complexity: 74` cannot be argued with,
+ * cannot be reproduced by hand, and does not tell anybody what to do on Monday.
+ * Worse, the weights that turn four measurements into one number are invented —
+ * and once invented they get tuned until the ranking looks right, which is
+ * fitting the metric to the answer.
+ *
+ * So this returns **the measurements**, each with a definition you can check
+ * against the prompt in front of you, and ranks on the one quantity that is not
+ * a matter of opinion: **what optimising it would actually save.** That figure
+ * comes from running the deterministic rules, not from a formula.
+ *
+ * The structural facts are the *explanation* for a prompt's position in that
+ * ranking, not a substitute for it. "1,204 tokens across 8 sentences" says why
+ * a prompt is worth looking at; "$310 a month recoverable" says whether it is
+ * worth looking at before the other thirty-nine.
+ *
+ * ## What each measurement means, exactly
+ *
+ * - **sentences** — spans ending in `.`, `!`, `?`, `。`, `！`, `？`, or a line
+ *   break where the line ends without punctuation (a bullet is a sentence).
+ *   Protected content is excluded, so a code block is not forty sentences.
+ * - **tokensPerSentence** — the verbosity signal, and the only ratio here. It
+ *   is length-independent: a padded 300-token prompt and a padded 3,000-token
+ *   one look the same, which is the point. Reported with units, never as an
+ *   index.
+ * - **examples / exampleTokens** — from `findExamples`, the same detector the
+ *   advisories use. Few-shot examples are usually the largest single block in
+ *   an expensive prompt and the easiest to trim by one.
+ * - **formatTokens** — a restated output format (a JSON schema written out
+ *   twice, or written out at all when the API takes a schema parameter).
+ * - **protectedTokens** — code, URLs, placeholders and tags. Counted separately
+ *   because **no amount of optimising will touch them**, and a prompt that is
+ *   80% code has far less headroom than its size suggests. Leaving this out is
+ *   how a ranking sends somebody to spend an afternoon on a file that cannot
+ *   move.
+ */
+export interface PromptProfile {
+    tokens: number;
+    /** Tokens that cannot be touched: code, URLs, placeholders, tags. */
+    protectedTokens: number;
+    sentences: number;
+    /** `tokens / sentences`, rounded to one decimal. Zero when there are none. */
+    tokensPerSentence: number;
+    examples: number;
+    exampleTokens: number;
+    /** Tokens in a restated output format, or 0. */
+    formatTokens: number;
+}
+/**
+ * Sentences in the mutable part of the prompt.
+ *
+ * Deliberately simple and stated rather than clever. An abbreviation splits a
+ * sentence in two here, and that is accepted: the number is used as a
+ * denominator for a verbosity ratio, where a few percent of noise changes
+ * nothing, and the alternative is a sentence tokeniser this project would then
+ * have to defend.
+ */
+export declare function countSentences(prompt: string): number;
+export interface ProfileOptions {
+    count?: TokenCounter;
+}
+/** Measures a prompt. Deterministic, offline, and free. */
+export declare function profilePrompt(prompt: string, options?: ProfileOptions): PromptProfile;
+//# sourceMappingURL=profile.d.ts.map

package/dist/profile.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"profile.d.ts","sourceRoot":"","sources":["../src/profile.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE/C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyCG;AAEH,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,qEAAqE;IACrE,eAAe,EAAE,MAAM,CAAC;IACxB,SAAS,EAAE,MAAM,CAAC;IAClB,8EAA8E;IAC9E,iBAAiB,EAAE,MAAM,CAAC;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,EAAE,MAAM,CAAC;IACtB,gDAAgD;IAChD,YAAY,EAAE,MAAM,CAAC;CACtB;AAID;;;;;;;;GAQG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAuBrD;AAED,MAAM,WAAW,cAAc;IAC7B,KAAK,CAAC,EAAE,YAAY,CAAC;CACtB;AAED,2DAA2D;AAC3D,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,GAAE,cAAmB,GAAG,aAAa,CAqBzF"}

package/dist/profile.js

@@ -0,0 +1,55 @@
+import { segment } from './segment.js';
+import { findExamples, findRestatedFormat } from './structure.js';
+import { estimateTokens } from './tokenizer.js';
+const SENTENCE_END = /[.!?。！？]+/;
+/**
+ * Sentences in the mutable part of the prompt.
+ *
+ * Deliberately simple and stated rather than clever. An abbreviation splits a
+ * sentence in two here, and that is accepted: the number is used as a
+ * denominator for a verbosity ratio, where a few percent of noise changes
+ * nothing, and the alternative is a sentence tokeniser this project would then
+ * have to defend.
+ */
+export function countSentences(prompt) {
+    let total = 0;
+    for (const piece of segment(prompt)) {
+        if (piece.kind === 'protected')
+            continue;
+        for (const line of piece.text.split('\n')) {
+            const trimmed = line.trim();
+            if (trimmed === '')
+                continue;
+            const parts = trimmed
+                .split(SENTENCE_END)
+                .map((part) => part.trim())
+                .filter((part) => part !== '');
+            // A line with no terminal punctuation is still one thing being said — a
+            // bullet, a heading, a rule in a list. Counting it as zero would make
+            // every bulleted prompt look infinitely verbose.
+            total += Math.max(1, parts.length);
+        }
+    }
+    return total;
+}
+/** Measures a prompt. Deterministic, offline, and free. */
+export function profilePrompt(prompt, options = {}) {
+    const count = options.count ?? estimateTokens;
+    const tokens = count(prompt);
+    const protectedTokens = segment(prompt)
+        .filter((piece) => piece.kind === 'protected')
+        .reduce((sum, piece) => sum + count(piece.text), 0);
+    const sentences = countSentences(prompt);
+    const examples = findExamples(prompt, count);
+    const format = findRestatedFormat(prompt, count);
+    return {
+        tokens,
+        protectedTokens,
+        sentences,
+        tokensPerSentence: sentences === 0 ? 0 : Math.round((tokens / sentences) * 10) / 10,
+        examples: examples.length,
+        exampleTokens: examples.reduce((sum, block) => sum + block.tokens, 0),
+        formatTokens: format?.restatedTokens ?? 0,
+    };
+}
+//# sourceMappingURL=profile.js.map

package/dist/profile.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"profile.js","sourceRoot":"","sources":["../src/profile.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACvC,OAAO,EAAE,YAAY,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AAClE,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AA2DhD,MAAM,YAAY,GAAG,WAAW,CAAC;AAEjC;;;;;;;;GAQG;AACH,MAAM,UAAU,cAAc,CAAC,MAAc;IAC3C,IAAI,KAAK,GAAG,CAAC,CAAC;IAEd,KAAK,MAAM,KAAK,IAAI,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;QACpC,IAAI,KAAK,CAAC,IAAI,KAAK,WAAW;YAAE,SAAS;QAEzC,KAAK,MAAM,IAAI,IAAI,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;YAC1C,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;YAC5B,IAAI,OAAO,KAAK,EAAE;gBAAE,SAAS;YAE7B,MAAM,KAAK,GAAG,OAAO;iBAClB,KAAK,CAAC,YAAY,CAAC;iBACnB,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;iBAC1B,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,KAAK,EAAE,CAAC,CAAC;YAEjC,wEAAwE;YACxE,sEAAsE;YACtE,iDAAiD;YACjD,KAAK,IAAI,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;QACrC,CAAC;IACH,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC;AAMD,2DAA2D;AAC3D,MAAM,UAAU,aAAa,CAAC,MAAc,EAAE,OAAO,GAAmB,EAAE;IACxE,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,IAAI,cAAc,CAAC;IAE9C,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC;IAC7B,MAAM,eAAe,GAAG,OAAO,CAAC,MAAM,CAAC;SACpC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,KAAK,WAAW,CAAC;SAC7C,MAAM,CAAC,CAAC,GAAG,EAAE,KAAK,EAAE,EAAE,CAAC,GAAG,GAAG,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC;IAEtD,MAAM,SAAS,GAAG,cAAc,CAAC,MAAM,CAAC,CAAC;IACzC,MAAM,QAAQ,GAAG,YAAY,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;IAC7C,MAAM,MAAM,GAAG,kBAAkB,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;IAEjD,OAAO;QACL,MAAM;QACN,eAAe;QACf,SAAS;QACT,iBAAiB,EAAE,SAAS,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,MAAM,GAAG,SAAS,CAAC,GAAG,EAAE,CAAC,GAAG,EAAE;QACnF,QAAQ,EAAE,QAAQ,CAAC,MAAM;QACzB,aAAa,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,KAAK,EAAE,EAAE,CAAC,GAAG,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC;QACrE,YAAY,EAAE,MAAM,EAAE,cAAc,IAAI,CAAC;KAC1C,CAAC;AACJ,CAAC"}

package/dist/promptfoo.d.ts

@@ -0,0 +1,58 @@
+/**
+ * Exports a before/after pair as a suite somebody else's harness can run.
+ *
+ * `trazum eval` answers "does the model still say the same thing?" — semantic
+ * agreement, measured against the model's own variance. That is the question
+ * Trazum is qualified to ask, and it is not the question a team actually needs
+ * answered before shipping. *Their* question is whether the classifier still
+ * hits 94%, whether the JSON still parses, whether the refusal rate moved. Those
+ * are assertions about their task, and Trazum has no business inventing them.
+ *
+ * So this hands over the part it *can* build correctly — a suite in which the
+ * only variable is the prompt, with both versions and every case already wired
+ * — and leaves the assertions where they belong.
+ *
+ * ## Why JSON rather than YAML
+ *
+ * promptfoo reads `promptfooconfig.json` as readily as the YAML. This package
+ * has no dependencies and is not going to acquire a YAML emitter, and a
+ * hand-rolled one would be a quoting bug waiting for the first prompt
+ * containing a colon, a tab, or a line ending in a space. `JSON.stringify`
+ * escapes everything correctly, and JSON is a subset of YAML, so the file can
+ * be renamed if somebody prefers.
+ */
+export interface PromptfooExport {
+    /** The config, ready for `JSON.stringify`. */
+    config: Record<string, unknown>;
+    /** Things the reader has to know before trusting the run. */
+    warnings: PromptfooWarning[];
+}
+export type PromptfooWarning = 
+/** `${x}` or `{x}`: promptfoo substitutes `{{x}}` and will leave these alone. */
+{
+    kind: 'unsupported-placeholder';
+    detail: string;
+}
+/** More than one distinct placeholder, and one value per case to fill them. */
+ | {
+    kind: 'multiple-placeholders';
+    detail: string;
+}
+/** The provider has no promptfoo id here, so the model string is a guess. */
+ | {
+    kind: 'unmapped-provider';
+    detail: string;
+}
+/** No placeholder at all: the case is appended, as `trazum eval` does. */
+ | {
+    kind: 'appended-input';
+    detail: string;
+};
+export interface PromptfooOptions {
+    /** Model id from Trazum's catalogue, mapped to a promptfoo provider. */
+    model?: string;
+    /** Rule level used to produce the optimised prompt, for the label. */
+    level?: string;
+}
+export declare function toPromptfoo(original: string, optimized: string, cases: readonly string[], options?: PromptfooOptions): PromptfooExport;
+//# sourceMappingURL=promptfoo.d.ts.map

package/dist/promptfoo.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"promptfoo.d.ts","sourceRoot":"","sources":["../src/promptfoo.ts"],"names":[],"mappings":"AAGA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,MAAM,WAAW,eAAe;IAC9B,8CAA8C;IAC9C,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChC,6DAA6D;IAC7D,QAAQ,EAAE,gBAAgB,EAAE,CAAC;CAC9B;AAED,MAAM,MAAM,gBAAgB;AAC1B,iFAAiF;AAC/E;IAAE,IAAI,EAAE,yBAAyB,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE;AACrD,+EAA+E;GAC7E;IAAE,IAAI,EAAE,uBAAuB,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE;AACnD,6EAA6E;GAC3E;IAAE,IAAI,EAAE,mBAAmB,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE;AAC/C,0EAA0E;GACxE;IAAE,IAAI,EAAE,gBAAgB,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAE/C,MAAM,WAAW,gBAAgB;IAC/B,wEAAwE;IACxE,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,sEAAsE;IACtE,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AA4ED,wBAAgB,WAAW,CACzB,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,SAAS,MAAM,EAAE,EACxB,OAAO,GAAE,gBAAqB,GAC7B,eAAe,CAkFjB"}