@trazum/core 1.8.0

package/dist/structure.js

@@ -0,0 +1,455 @@
+import { segment } from './segment.js';
+import { OUTPUT_CUES } from './phrases.js';
+import { jaccard, normalizeForCompare } from './similarity.js';
+/**
+ * Verbs that mark a sentence as being about the *response*.
+ *
+ * Requiring one is what keeps "translate this into English" from being read as
+ * "answer in English". Without it the language axis fires on any prompt that
+ * merely mentions a language, which is most translation prompts.
+ */
+const RESPOND = String.raw `(?:respond|reply|answer|write|speak|output|responde|contesta|responder|escribe|redacta)`;
+const AXES = [
+    {
+        axis: 'response-language',
+        values: [
+            [
+                'fixed-language',
+                new RegExp(String.raw `\b${RESPOND}\b[^.!?\n]{0,40}?\bin\s+(?:english|spanish|french|german|italian|portuguese|ingl[ée]s|espa[nñ]ol|franc[ée]s|alem[áa]n)\b|\b${RESPOND}\b[^.!?\n]{0,40}?\ben\s+(?:ingl[ée]s|espa[nñ]ol|franc[ée]s|alem[áa]n)\b`, 'i'),
+            ],
+            [
+                'mirror-language',
+                new RegExp(
+                // The qualifier slot ("own", "native", "preferred") is what makes
+                // this survive real prompts: "the customer's own language" is at
+                // least as common as the bare form.
+                String.raw `\bin\s+the\s+(?:same\s+)?language\s+(?:of|as|the\s+\w+\s+(?:used|wrote|speaks))|\bin\s+(?:the\s+(?:user|customer|client)'?s?|their)\s+(?:own\s+|native\s+|preferred\s+)?language\b|\bmatch\s+the\s+language\b|\ben\s+(?:el\s+)?(?:mismo\s+)?idioma\s+(?:del?\s+|en\s+que\s+)?(?:usuario|cliente|consulta|mensaje|escrib)`, 'i'),
+            ],
+        ],
+    },
+    {
+        axis: 'output-format',
+        values: [
+            [
+                'format-json',
+                new RegExp(String.raw `\b(?:${RESPOND}|return|format|devuelve|formatea)\b[^.!?\n]{0,40}?\b(?:as|in|with|using|only|en|como)\s+(?:valid\s+|solo\s+|válido\s+)?json\b|\bonly\s+json\b|\bsolo\s+json\b`, 'i'),
+            ],
+            [
+                'format-markdown',
+                new RegExp(String.raw `\b(?:${RESPOND}|return|format|devuelve|formatea)\b[^.!?\n]{0,40}?\b(?:as|in|with|using|en|como)\s+markdown\b|\buse\s+markdown\b|\busa\s+markdown\b`, 'i'),
+            ],
+            [
+                'format-plain-text',
+                new RegExp(String.raw `\bplain\s+text\b|\bno\s+markdown\b|\bwithout\s+markdown\b|\btexto\s+plano\b|\bsin\s+markdown\b`, 'i'),
+            ],
+        ],
+    },
+    {
+        axis: 'response-length',
+        values: [
+            [
+                'length-brief',
+                new RegExp(String.raw `\b(?:be\s+(?:brief|concise|succinct|terse)|keep\s+it\s+(?:short|brief)|as\s+short\s+as\s+possible|in\s+(?:one|a\s+single)\s+sentence|s[ée]\s+(?:breve|conciso)|de\s+forma\s+(?:breve|concisa)|brevemente)\b`, 'i'),
+            ],
+            [
+                'length-detailed',
+                new RegExp(String.raw `\b(?:be\s+(?:detailed|comprehensive|thorough|exhaustive)|in\s+(?:great\s+)?depth|as\s+much\s+detail\s+as\s+possible|s[ée]\s+(?:exhaustivo|detallado)|de\s+forma\s+(?:detallada|exhaustiva)|con\s+todo\s+detalle|detalladamente)\b`, 'i'),
+            ],
+        ],
+    },
+    {
+        axis: 'reasoning-visibility',
+        values: [
+            [
+                'reasoning-shown',
+                new RegExp(String.raw `\b(?:explain\s+your\s+(?:reasoning|answer|thinking)|show\s+your\s+(?:work|reasoning|thinking)|think\s+step[\s-]by[\s-]step|justify\s+your\s+answer|explica\s+tu\s+razonamiento|razona\s+paso\s+a\s+paso|justifica\s+tu\s+respuesta)\b`, 'i'),
+            ],
+            [
+                'reasoning-hidden',
+                new RegExp(String.raw `\b(?:no\s+(?:explanation|commentary|preamble)|without\s+(?:explanation|commentary)|do\s+not\s+explain|don'?t\s+explain|no\s+expliques|sin\s+(?:explicaciones|comentarios)|sin\s+preámbulo)\b`, 'i'),
+            ],
+        ],
+    },
+];
+/**
+ * Text the analysis is allowed to read.
+ *
+ * Protected segments are replaced by a space rather than kept: a JSON schema
+ * inside a code fence is the *specification* of the output format, not a
+ * second instruction about it, and reading it as one would report a
+ * contradiction in every well-written prompt that shows its schema.
+ */
+function analysableText(prompt) {
+    return segment(prompt)
+        .map((s) => (s.kind === 'mutable' ? s.text : ' '))
+        .join('');
+}
+/** Splits into sentences, keeping line breaks as boundaries. */
+function sentences(text) {
+    return text
+        .split(/(?<=[.!?;:])\s+|\n+/)
+        .map((s) => s.trim())
+        .filter(Boolean);
+}
+function trimSnippet(sentence, max = 90) {
+    const clean = sentence.replace(/\s+/g, ' ').trim();
+    return clean.length <= max ? clean : `${clean.slice(0, max - 1)}…`;
+}
+/**
+ * Finds instructions that pull in opposite directions on the same axis.
+ *
+ * Only the first occurrence of each value is kept, and an axis reports at most
+ * one contradiction: a prompt that says "be concise" four times and "be
+ * thorough" once has one problem, not four.
+ *
+ * Two matches inside the same sentence are ignored. "Be concise but complete"
+ * is a deliberate trade-off an author wrote on purpose; flagging it would
+ * train people to ignore the advisory.
+ */
+export function findContradictions(prompt) {
+    const found = [];
+    const lines = sentences(analysableText(prompt));
+    for (const { axis, values } of AXES) {
+        const hits = new Map();
+        lines.forEach((sentence, index) => {
+            for (const [value, pattern] of values) {
+                if (!hits.has(value) && pattern.test(sentence)) {
+                    hits.set(value, { snippet: trimSnippet(sentence), sentence: index });
+                }
+            }
+        });
+        if (hits.size < 2)
+            continue;
+        const [first, second] = [...hits.entries()];
+        if (!first || !second)
+            continue;
+        if (first[1].sentence === second[1].sentence)
+            continue;
+        found.push({
+            axis,
+            a: { value: first[0], snippet: first[1].snippet },
+            b: { value: second[0], snippet: second[1].snippet },
+        });
+    }
+    return found;
+}
+// --------------------------------------------------------------------------
+// Redundant few-shot examples
+// --------------------------------------------------------------------------
+/**
+ * The two halves of an example label, as bounded fragments.
+ *
+ * Every quantifier here has an upper bound, and that is load-bearing rather
+ * than tidiness. The previous form ended `\s*\d*\s*[:.)]` — three adjacent
+ * unbounded quantifiers over overlapping character classes. On a line like
+ * `example` followed by 40 000 spaces and no terminator, the engine has to try
+ * every way of splitting that whitespace between the two `\s*` groups before
+ * it can fail: measured O(n²), 651 ms at 40 000 spaces, roughly a minute at
+ * the API's 400 KB cap — a denial of service in one request.
+ *
+ * Bounding turns the split count into a constant. A label reading
+ * `Example 12:` never needs more than a few spaces or six digits, so nothing
+ * real is lost.
+ *
+ * `[ \t]` rather than `\s` because these are matched per line, where `\s`
+ * matching newlines is wrong anyway.
+ */
+const LABEL_PREFIX = String.raw `^[ \t]{0,16}(?:#{1,6}[ \t]{0,4})?(?:[-*][ \t]{0,4})?`;
+const LABEL_SUFFIX = String.raw `[ \t]{0,4}\d{0,6}[ \t]{0,4}[:.)]`;
+/**
+ * Header styles that open a new example, most explicit first.
+ *
+ * Tiered rather than combined because they nest: a prompt using "Example 1:"
+ * almost always puts "Input:"/"Output:" *inside* each example, so matching
+ * both at once would cut every example in half and compare the halves. The
+ * first tier that finds at least two blocks wins.
+ *
+ * Deliberately conservative overall: an unlabelled example is
+ * indistinguishable from ordinary prose, and guessing would make the advisory
+ * fire on prompts containing no examples at all.
+ */
+const EXAMPLE_HEADER_TIERS = [
+    new RegExp(`${LABEL_PREFIX}(?:example|ejemplo)${LABEL_SUFFIX}`, 'i'),
+    new RegExp(`${LABEL_PREFIX}(?:input|entrada)${LABEL_SUFFIX}`, 'i'),
+    new RegExp(`${LABEL_PREFIX}(?:user|usuario|q)${LABEL_SUFFIX}`, 'i'),
+];
+/**
+ * A labelled field inside a few-shot example — `Input:`, `Output:`, `A:`…
+ *
+ * Exported because the duplicate-line rule needs it: two examples that share
+ * an output line are demonstrating that two different inputs map to the *same*
+ * answer, which is often the whole point of including both. Deduplicating
+ * those lines leaves an example with no output at all — worse than the
+ * repetition it removed.
+ */
+export const EXAMPLE_FIELD_LINE = new RegExp(`${LABEL_PREFIX}(?:input|output|entrada|salida|example|ejemplo|user|usuario|assistant|asistente|q|a|question|answer|pregunta|respuesta)${LABEL_SUFFIX}`, 'i');
+/**
+ * Similarity at which two examples are treated as repeating each other.
+ *
+ * Lower than the 0.92 the near-duplicate *rule* uses, because that rule
+ * deletes and this only reports.
+ *
+ * What this threshold actually catches, measured on realistic pairs: a
+ * copy-pasted example with one field changed scores ~0.89, a lightly edited
+ * copy ~0.80, two genuinely different examples ~0.20. A *paraphrase* — the
+ * same lesson taught in different words — scores ~0.54 and is deliberately
+ * NOT caught, because it sits close enough to the distinct case that catching
+ * it would mean flagging examples that teach different things.
+ *
+ * So this finds copy-paste accumulation, which is how few-shot blocks actually
+ * grow, and not semantic redundancy. Recognising that "arrived quickly" and
+ * "arrived fast" teach the same thing needs a model, not a word-set overlap;
+ * that belongs to the optional LLM pass, not here.
+ */
+const EXAMPLE_SIMILARITY = 0.7;
+/** Splits the prompt on one header style. */
+function splitOnHeader(lines, header) {
+    const blocks = [];
+    let current = null;
+    let inFence = false;
+    for (const line of lines) {
+        // A header inside a fenced block is part of the example, not a new one.
+        if (/^\s*(?:```|~~~)/.test(line))
+            inFence = !inFence;
+        if (!inFence && header.test(line)) {
+            current = [line];
+            blocks.push(current);
+            continue;
+        }
+        if (current)
+            current.push(line);
+    }
+    return blocks.map((block) => trimToExample(block.join('\n'))).filter(Boolean);
+}
+/**
+ * Cuts a block off where the example stops and ordinary prose resumes.
+ *
+ * Without this the final example runs to the end of the prompt and absorbs
+ * every instruction that follows it, which inflates its length and drags its
+ * similarity to the others below any sensible threshold — so the one block
+ * most likely to be a duplicate is the one that never gets reported.
+ *
+ * A paragraph belongs to the example while it still contains a labelled field;
+ * the first that does not ends the block.
+ */
+function trimToExample(block) {
+    const paragraphs = block.split(/\n\s*\n/);
+    const kept = [paragraphs[0] ?? ''];
+    for (const paragraph of paragraphs.slice(1)) {
+        const isExampleContent = paragraph
+            .split('\n')
+            .some((line) => EXAMPLE_FIELD_LINE.test(line));
+        if (!isExampleContent)
+            break;
+        kept.push(paragraph);
+    }
+    return kept.join('\n\n').trim();
+}
+/** Splits the prompt into labelled example blocks. */
+export function findExamples(prompt, count) {
+    const lines = prompt.split('\n');
+    for (const header of EXAMPLE_HEADER_TIERS) {
+        const blocks = splitOnHeader(lines, header);
+        if (blocks.length >= 2) {
+            return blocks.map((text) => ({ text, tokens: count(text) }));
+        }
+    }
+    return [];
+}
+/**
+ * Reports examples that repeat what an earlier example already demonstrates.
+ *
+ * Each example is compared against every earlier one, and blamed on the first
+ * match: in a run of three near-identical examples the second and third are
+ * both reported against the first, rather than chaining.
+ */
+export function analyzeExamples(prompt, count) {
+    const examples = findExamples(prompt, count);
+    const normalized = examples.map((e) => normalizeForCompare(e.text));
+    const redundant = [];
+    for (let i = 1; i < examples.length; i++) {
+        for (let j = 0; j < i; j++) {
+            const similarity = jaccard(normalized[i], normalized[j]);
+            if (similarity >= EXAMPLE_SIMILARITY) {
+                redundant.push({
+                    duplicateOf: j,
+                    index: i,
+                    similarity,
+                    tokens: examples[i].tokens,
+                });
+                break;
+            }
+        }
+    }
+    return {
+        examples,
+        redundant,
+        redundantTokens: redundant.reduce((sum, r) => sum + r.tokens, 0),
+    };
+}
+/** Fenced blocks, with their info string. */
+function fencedBlocks(prompt) {
+    const blocks = [];
+    const fence = /^([ \t]{0,3})(`{3,}|~{3,})([^\n]*)\n([\s\S]*?)^\1\2[ \t]*$/gm;
+    let match;
+    while ((match = fence.exec(prompt)) !== null) {
+        blocks.push({ lang: (match[3] ?? '').trim().toLowerCase(), body: match[4] ?? '' });
+    }
+    return blocks;
+}
+/**
+ * Top-level keys of a JSON-ish block.
+ *
+ * Deliberately a scan rather than `JSON.parse`: schemas in prompts are
+ * routinely illustrative — trailing commas, `...`, comments, a placeholder
+ * where a value goes — and refusing to read those would skip exactly the
+ * prompts worth checking. Only keys at nesting depth 1 count, so a nested
+ * field name cannot be mistaken for a top-level one.
+ */
+function topLevelKeys(body) {
+    const keys = [];
+    let depth = 0;
+    let inString = false;
+    let quote = '';
+    let current = '';
+    for (let i = 0; i < body.length; i++) {
+        const ch = body[i];
+        if (inString) {
+            if (ch === '\\') {
+                current += body[i + 1] ?? '';
+                i++;
+                continue;
+            }
+            if (ch === quote) {
+                inString = false;
+                // A string is a key only when the next non-space character is a colon.
+                const rest = body.slice(i + 1);
+                const colon = /^\s*:/.test(rest);
+                if (colon && depth === 1 && current)
+                    keys.push(current);
+                current = '';
+                continue;
+            }
+            current += ch;
+            continue;
+        }
+        if (ch === '"' || ch === "'") {
+            inString = true;
+            quote = ch;
+            current = '';
+            continue;
+        }
+        if (ch === '{' || ch === '[')
+            depth++;
+        else if (ch === '}' || ch === ']')
+            depth--;
+    }
+    return [...new Set(keys)];
+}
+/** Minimum keys that must be restated before this is worth reporting. */
+const RESTATED_KEY_MINIMUM = 3;
+/**
+ * Finds an output schema that the prose repeats.
+ *
+ * The threshold is deliberately blunt: naming one or two fields in prose is
+ * ordinary ("set `escalate` to true when the customer asks for a human"), and
+ * flagging that would make the advisory noise. Three or more, and the prose is
+ * walking the schema.
+ */
+export function findRestatedFormat(prompt, count) {
+    const blocks = fencedBlocks(prompt);
+    const keys = [
+        ...new Set(blocks
+            .filter((b) => b.lang === '' || /json|jsonc|json5|yaml|yml/.test(b.lang))
+            .flatMap((b) => topLevelKeys(b.body))),
+    ].filter((k) => k.length >= 3);
+    if (keys.length < RESTATED_KEY_MINIMUM)
+        return null;
+    // Prose only: the schema naming its own keys is not a restatement.
+    const prose = analysableText(prompt);
+    const proseSentences = sentences(prose);
+    const restatedKeys = new Set();
+    const guiltySentences = new Set();
+    proseSentences.forEach((sentence, index) => {
+        for (const key of keys) {
+            // Word boundary that also survives snake_case and kebab-case names.
+            const pattern = new RegExp(`(?<![\\p{L}\\p{N}_-])${escapeRegExp(key)}(?![\\p{L}\\p{N}_-])`, 'iu');
+            if (pattern.test(sentence)) {
+                restatedKeys.add(key);
+                guiltySentences.add(index);
+            }
+        }
+    });
+    if (restatedKeys.size < RESTATED_KEY_MINIMUM)
+        return null;
+    const restatedTokens = count([...guiltySentences].map((i) => proseSentences[i]).join(' '));
+    return {
+        keys,
+        restatedKeys: [...restatedKeys],
+        restatedTokens,
+    };
+}
+function escapeRegExp(text) {
+    return text.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+}
+/** How far back to look for a cue introducing a block. */
+const CUE_WINDOW = 240;
+/** Fenced blocks with their offset, needed to read what precedes them. */
+function fencedBlocksAt(prompt) {
+    const blocks = [];
+    const fence = /^([ \t]{0,3})(`{3,}|~{3,})([^\n]*)\n([\s\S]*?)^\1\2[ \t]*$/gm;
+    let match;
+    while ((match = fence.exec(prompt)) !== null) {
+        blocks.push({
+            lang: (match[3] ?? '').trim().toLowerCase(),
+            body: match[4] ?? '',
+            at: match.index,
+            raw: match[0],
+        });
+    }
+    return blocks;
+}
+export function findMovableSchema(prompt, count) {
+    const cued = [];
+    for (const block of fencedBlocksAt(prompt)) {
+        // Explicitly JSON-ish, or unlabelled but structured enough to be a shape.
+        // A labelled `python` block is somebody's code and never an output contract.
+        const jsonish = /^(json|jsonc|json5)$/.test(block.lang) || block.lang === '';
+        if (!jsonish)
+            continue;
+        /**
+         * No minimum key *length* here, unlike the restated-format detector.
+         * That filter exists there to stop a two-letter key matching a word in
+         * prose; nothing is matched against prose here, so all it would do is
+         * undercount schemas whose fields are called `id` or `ok`. It was copied
+         * across in the first draft and a mutation run found it: deleting it changed
+         * no test, which is what a line with no reason looks like.
+         */
+        const keys = topLevelKeys(block.body);
+        // Fewer than three keys is an illustration, not a contract worth moving —
+        // the same threshold the restated-format advisory uses, for the same reason.
+        if (keys.length < RESTATED_KEY_MINIMUM)
+            continue;
+        /**
+         * The window before the fence, normalised the way every other comparison in
+         * this package normalises: case folded, accents stripped, punctuation
+         * flattened. `Formato de salida:` and `FORMATO DE SALIDA —` are the same cue,
+         * and a dictionary that only matched one of them would cover Spanish on
+         * paper.
+         */
+        const lead = normalizeForCompare(prompt.slice(Math.max(0, block.at - CUE_WINDOW), block.at));
+        const cue = OUTPUT_CUES.find((phrase) => lead.includes(normalizeForCompare(phrase)));
+        if (cue === undefined)
+            continue;
+        cued.push({ raw: block.raw, keys, cue });
+    }
+    if (cued.length === 0)
+        return null;
+    return {
+        blocks: cued.length,
+        keys: [...new Set(cued.flatMap((block) => block.keys))],
+        tokens: count(cued.map((block) => block.raw).join('\n\n')),
+        cue: cued[0]?.cue ?? '',
+    };
+}
+//# sourceMappingURL=structure.js.map

package/dist/structure.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"structure.js","sourceRoot":"","sources":["../src/structure.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACvC,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAC3C,OAAO,EAAE,OAAO,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AA6C/D;;;;;;GAMG;AACH,MAAM,OAAO,GAAG,MAAM,CAAC,GAAG,CAAA,yFAAyF,CAAC;AAEpH,MAAM,IAAI,GAA8B;IACtC;QACE,IAAI,EAAE,mBAAmB;QACzB,MAAM,EAAE;YACN;gBACE,gBAAgB;gBAChB,IAAI,MAAM,CACR,MAAM,CAAC,GAAG,CAAA,KAAK,OAAO,8HAA8H,OAAO,yEAAyE,EACpO,GAAG,CACJ;aACF;YACD;gBACE,iBAAiB;gBACjB,IAAI,MAAM;gBACR,kEAAkE;gBAClE,iEAAiE;gBACjE,oCAAoC;gBACpC,MAAM,CAAC,GAAG,CAAA,0TAA0T,EACpU,GAAG,CACJ;aACF;SACF;KACF;IACD;QACE,IAAI,EAAE,eAAe;QACrB,MAAM,EAAE;YACN;gBACE,aAAa;gBACb,IAAI,MAAM,CACR,MAAM,CAAC,GAAG,CAAA,QAAQ,OAAO,+JAA+J,EACxL,GAAG,CACJ;aACF;YACD;gBACE,iBAAiB;gBACjB,IAAI,MAAM,CACR,MAAM,CAAC,GAAG,CAAA,QAAQ,OAAO,qIAAqI,EAC9J,GAAG,CACJ;aACF;YACD;gBACE,mBAAmB;gBACnB,IAAI,MAAM,CACR,MAAM,CAAC,GAAG,CAAA,gGAAgG,EAC1G,GAAG,CACJ;aACF;SACF;KACF;IACD;QACE,IAAI,EAAE,iBAAiB;QACvB,MAAM,EAAE;YACN;gBACE,cAAc;gBACd,IAAI,MAAM,CACR,MAAM,CAAC,GAAG,CAAA,6MAA6M,EACvN,GAAG,CACJ;aACF;YACD;gBACE,iBAAiB;gBACjB,IAAI,MAAM,CACR,MAAM,CAAC,GAAG,CAAA,mOAAmO,EAC7O,GAAG,CACJ;aACF;SACF;KACF;IACD;QACE,IAAI,EAAE,sBAAsB;QAC5B,MAAM,EAAE;YACN;gBACE,iBAAiB;gBACjB,IAAI,MAAM,CACR,MAAM,CAAC,GAAG,CAAA,uOAAuO,EACjP,GAAG,CACJ;aACF;YACD;gBACE,kBAAkB;gBAClB,IAAI,MAAM,CACR,MAAM,CAAC,GAAG,CAAA,8LAA8L,EACxM,GAAG,CACJ;aACF;SACF;KACF;CACF,CAAC;AAEF;;;;;;;GAOG;AACH,SAAS,cAAc,CAAC,MAAc;IACpC,OAAO,OAAO,CAAC,MAAM,CAAC;SACnB,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;SACjD,IAAI,CAAC,EAAE,CAAC,CAAC;AACd,CAAC;AAED,gEAAgE;AAChE,SAAS,SAAS,CAAC,IAAY;IAC7B,OAAO,IAAI;SACR,KAAK,CAAC,qBAAqB,CAAC;SAC5B,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;SACpB,MAAM,CAAC,OAAO,CAAC,CAAC;AACrB,CAAC;AAED,SAAS,WAAW,CAAC,QAAgB,EAAE,GAAG,GAAG,EAAE;IAC7C,MAAM,KAAK,GAAG,QAAQ,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;IACnD,OAAO,KAAK,CAAC,MAAM,IAAI,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,GAAG,CAAC,CAAC,GAAG,CAAC;AACrE,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,kBAAkB,CAAC,MAAc;IAC/C,MAAM,KAAK,GAAoB,EAAE,CAAC;IAClC,MAAM,KAAK,GAAG,SAAS,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC,CAAC;IAEhD,KAAK,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,IAAI,EAAE,CAAC;QACpC,MAAM,IAAI,GAAG,IAAI,GAAG,EAA+D,CAAC;QAEpF,KAAK,CAAC,OAAO,CAAC,CAAC,QAAQ,EAAE,KAAK,EAAE,EAAE;YAChC,KAAK,MAAM,CAAC,KAAK,EAAE,OAAO,CAAC,IAAI,MAAM,EAAE,CAAC;gBACtC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC;oBAC/C,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,EAAE,OAAO,EAAE,WAAW,CAAC,QAAQ,CAAC,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC,CAAC;gBACvE,CAAC;YACH,CAAC;QACH,CAAC,CAAC,CAAC;QAEH,IAAI,IAAI,CAAC,IAAI,GAAG,CAAC;YAAE,SAAS;QAE5B,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC;QAC5C,IAAI,CAAC,KAAK,IAAI,CAAC,MAAM;YAAE,SAAS;QAChC,IAAI,KAAK,CAAC,CAAC,CAAC,CAAC,QAAQ,KAAK,MAAM,CAAC,CAAC,CAAC,CAAC,QAAQ;YAAE,SAAS;QAEvD,KAAK,CAAC,IAAI,CAAC;YACT,IAAI;YACJ,CAAC,EAAE,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,OAAO,EAAE;YACjD,CAAC,EAAE,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,OAAO,EAAE;SACpD,CAAC,CAAC;IACL,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC;AAED,6EAA6E;AAC7E,8BAA8B;AAC9B,6EAA6E;AAE7E;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,YAAY,GAAG,MAAM,CAAC,GAAG,CAAA,sDAAsD,CAAC;AACtF,MAAM,YAAY,GAAG,MAAM,CAAC,GAAG,CAAA,kCAAkC,CAAC;AAElE;;;;;;;;;;;GAWG;AACH,MAAM,oBAAoB,GAAsB;IAC9C,IAAI,MAAM,CAAC,GAAG,YAAY,sBAAsB,YAAY,EAAE,EAAE,GAAG,CAAC;IACpE,IAAI,MAAM,CAAC,GAAG,YAAY,oBAAoB,YAAY,EAAE,EAAE,GAAG,CAAC;IAClE,IAAI,MAAM,CAAC,GAAG,YAAY,qBAAqB,YAAY,EAAE,EAAE,GAAG,CAAC;CACpE,CAAC;AAEF;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,IAAI,MAAM,CAC1C,GAAG,YAAY,0HAA0H,YAAY,EAAE,EACvJ,GAAG,CACJ,CAAC;AAsBF;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,kBAAkB,GAAG,GAAG,CAAC;AAE/B,6CAA6C;AAC7C,SAAS,aAAa,CAAC,KAAwB,EAAE,MAAc;IAC7D,MAAM,MAAM,GAAe,EAAE,CAAC;IAC9B,IAAI,OAAO,GAAoB,IAAI,CAAC;IACpC,IAAI,OAAO,GAAG,KAAK,CAAC;IAEpB,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,wEAAwE;QACxE,IAAI,iBAAiB,CAAC,IAAI,CAAC,IAAI,CAAC;YAAE,OAAO,GAAG,CAAC,OAAO,CAAC;QAErD,IAAI,CAAC,OAAO,IAAI,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;YAClC,OAAO,GAAG,CAAC,IAAI,CAAC,CAAC;YACjB,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YACrB,SAAS;QACX,CAAC;QACD,IAAI,OAAO;YAAE,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAClC,CAAC;IAED,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,aAAa,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;AAChF,CAAC;AAED;;;;;;;;;;GAUG;AACH,SAAS,aAAa,CAAC,KAAa;IAClC,MAAM,UAAU,GAAG,KAAK,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;IAC1C,MAAM,IAAI,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;IAEnC,KAAK,MAAM,SAAS,IAAI,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;QAC5C,MAAM,gBAAgB,GAAG,SAAS;aAC/B,KAAK,CAAC,IAAI,CAAC;aACX,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,kBAAkB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;QACjD,IAAI,CAAC,gBAAgB;YAAE,MAAM;QAC7B,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IACvB,CAAC;IAED,OAAO,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,CAAC;AAClC,CAAC;AAED,sDAAsD;AACtD,MAAM,UAAU,YAAY,CAAC,MAAc,EAAE,KAAmB;IAC9D,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAEjC,KAAK,MAAM,MAAM,IAAI,oBAAoB,EAAE,CAAC;QAC1C,MAAM,MAAM,GAAG,aAAa,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;QAC5C,IAAI,MAAM,CAAC,MAAM,IAAI,CAAC,EAAE,CAAC;YACvB,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC;QAC/D,CAAC;IACH,CAAC;IAED,OAAO,EAAE,CAAC;AACZ,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,eAAe,CAAC,MAAc,EAAE,KAAmB;IACjE,MAAM,QAAQ,GAAG,YAAY,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;IAC7C,MAAM,UAAU,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,mBAAmB,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;IACpE,MAAM,SAAS,GAAuB,EAAE,CAAC;IAEzC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,QAAQ,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACzC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;YAC3B,MAAM,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC,CAAE,EAAE,UAAU,CAAC,CAAC,CAAE,CAAC,CAAC;YAC3D,IAAI,UAAU,IAAI,kBAAkB,EAAE,CAAC;gBACrC,SAAS,CAAC,IAAI,CAAC;oBACb,WAAW,EAAE,CAAC;oBACd,KAAK,EAAE,CAAC;oBACR,UAAU;oBACV,MAAM,EAAE,QAAQ,CAAC,CAAC,CAAE,CAAC,MAAM;iBAC5B,CAAC,CAAC;gBACH,MAAM;YACR,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO;QACL,QAAQ;QACR,SAAS;QACT,eAAe,EAAE,SAAS,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC;KACjE,CAAC;AACJ,CAAC;AAyBD,6CAA6C;AAC7C,SAAS,YAAY,CAAC,MAAc;IAClC,MAAM,MAAM,GAA0C,EAAE,CAAC;IACzD,MAAM,KAAK,GAAG,8DAA8D,CAAC;IAC7E,IAAI,KAA6B,CAAC;IAClC,OAAO,CAAC,KAAK,GAAG,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC;QAC7C,MAAM,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;IACrF,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;;;;;;;GAQG;AACH,SAAS,YAAY,CAAC,IAAY;IAChC,MAAM,IAAI,GAAa,EAAE,CAAC;IAC1B,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,IAAI,QAAQ,GAAG,KAAK,CAAC;IACrB,IAAI,KAAK,GAAG,EAAE,CAAC;IACf,IAAI,OAAO,GAAG,EAAE,CAAC;IAEjB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACrC,MAAM,EAAE,GAAG,IAAI,CAAC,CAAC,CAAE,CAAC;QAEpB,IAAI,QAAQ,EAAE,CAAC;YACb,IAAI,EAAE,KAAK,IAAI,EAAE,CAAC;gBAChB,OAAO,IAAI,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;gBAC7B,CAAC,EAAE,CAAC;gBACJ,SAAS;YACX,CAAC;YACD,IAAI,EAAE,KAAK,KAAK,EAAE,CAAC;gBACjB,QAAQ,GAAG,KAAK,CAAC;gBACjB,uEAAuE;gBACvE,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;gBAC/B,MAAM,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;gBACjC,IAAI,KAAK,IAAI,KAAK,KAAK,CAAC,IAAI,OAAO;oBAAE,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;gBACxD,OAAO,GAAG,EAAE,CAAC;gBACb,SAAS;YACX,CAAC;YACD,OAAO,IAAI,EAAE,CAAC;YACd,SAAS;QACX,CAAC;QAED,IAAI,EAAE,KAAK,GAAG,IAAI,EAAE,KAAK,GAAG,EAAE,CAAC;YAC7B,QAAQ,GAAG,IAAI,CAAC;YAChB,KAAK,GAAG,EAAE,CAAC;YACX,OAAO,GAAG,EAAE,CAAC;YACb,SAAS;QACX,CAAC;QACD,IAAI,EAAE,KAAK,GAAG,IAAI,EAAE,KAAK,GAAG;YAAE,KAAK,EAAE,CAAC;aACjC,IAAI,EAAE,KAAK,GAAG,IAAI,EAAE,KAAK,GAAG;YAAE,KAAK,EAAE,CAAC;IAC7C,CAAC;IAED,OAAO,CAAC,GAAG,IAAI,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC;AAC5B,CAAC;AAED,yEAAyE;AACzE,MAAM,oBAAoB,GAAG,CAAC,CAAC;AAE/B;;;;;;;GAOG;AACH,MAAM,UAAU,kBAAkB,CAAC,MAAc,EAAE,KAAmB;IACpE,MAAM,MAAM,GAAG,YAAY,CAAC,MAAM,CAAC,CAAC;IACpC,MAAM,IAAI,GAAG;QACX,GAAG,IAAI,GAAG,CACR,MAAM;aACH,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,EAAE,IAAI,2BAA2B,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;aACxE,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,YAAY,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CACxC;KACF,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,IAAI,CAAC,CAAC,CAAC;IAE/B,IAAI,IAAI,CAAC,MAAM,GAAG,oBAAoB;QAAE,OAAO,IAAI,CAAC;IAEpD,mEAAmE;IACnE,MAAM,KAAK,GAAG,cAAc,CAAC,MAAM,CAAC,CAAC;IACrC,MAAM,cAAc,GAAG,SAAS,CAAC,KAAK,CAAC,CAAC;IAExC,MAAM,YAAY,GAAG,IAAI,GAAG,EAAU,CAAC;IACvC,MAAM,eAAe,GAAG,IAAI,GAAG,EAAU,CAAC;IAE1C,cAAc,CAAC,OAAO,CAAC,CAAC,QAAQ,EAAE,KAAK,EAAE,EAAE;QACzC,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;YACvB,oEAAoE;YACpE,MAAM,OAAO,GAAG,IAAI,MAAM,CAAC,wBAAwB,YAAY,CAAC,GAAG,CAAC,sBAAsB,EAAE,IAAI,CAAC,CAAC;YAClG,IAAI,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC;gBAC3B,YAAY,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;gBACtB,eAAe,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;YAC7B,CAAC;QACH,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,IAAI,YAAY,CAAC,IAAI,GAAG,oBAAoB;QAAE,OAAO,IAAI,CAAC;IAE1D,MAAM,cAAc,GAAG,KAAK,CAAC,CAAC,GAAG,eAAe,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;IAE3F,OAAO;QACL,IAAI;QACJ,YAAY,EAAE,CAAC,GAAG,YAAY,CAAC;QAC/B,cAAc;KACf,CAAC;AACJ,CAAC;AAED,SAAS,YAAY,CAAC,IAAY;IAChC,OAAO,IAAI,CAAC,OAAO,CAAC,qBAAqB,EAAE,MAAM,CAAC,CAAC;AACrD,CAAC;AA2CD,0DAA0D;AAC1D,MAAM,UAAU,GAAG,GAAG,CAAC;AAEvB,0EAA0E;AAC1E,SAAS,cAAc,CAAC,MAAc;IACpC,MAAM,MAAM,GAAmE,EAAE,CAAC;IAClF,MAAM,KAAK,GAAG,8DAA8D,CAAC;IAC7E,IAAI,KAA6B,CAAC;IAClC,OAAO,CAAC,KAAK,GAAG,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC;QAC7C,MAAM,CAAC,IAAI,CAAC;YACV,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE;YAC3C,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE;YACpB,EAAE,EAAE,KAAK,CAAC,KAAK;YACf,GAAG,EAAE,KAAK,CAAC,CAAC,CAAC;SACd,CAAC,CAAC;IACL,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,MAAc,EAAE,KAAmB;IACnE,MAAM,IAAI,GAAwD,EAAE,CAAC;IAErE,KAAK,MAAM,KAAK,IAAI,cAAc,CAAC,MAAM,CAAC,EAAE,CAAC;QAC3C,0EAA0E;QAC1E,6EAA6E;QAC7E,MAAM,OAAO,GAAG,sBAAsB,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,KAAK,CAAC,IAAI,KAAK,EAAE,CAAC;QAC7E,IAAI,CAAC,OAAO;YAAE,SAAS;QAEvB;;;;;;;WAOG;QACH,MAAM,IAAI,GAAG,YAAY,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACtC,0EAA0E;QAC1E,6EAA6E;QAC7E,IAAI,IAAI,CAAC,MAAM,GAAG,oBAAoB;YAAE,SAAS;QAEjD;;;;;;WAMG;QACH,MAAM,IAAI,GAAG,mBAAmB,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,CAAC,EAAE,GAAG,UAAU,CAAC,EAAE,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC;QAC7F,MAAM,GAAG,GAAG,WAAW,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,mBAAmB,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;QACrF,IAAI,GAAG,KAAK,SAAS;YAAE,SAAS;QAEhC,IAAI,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,KAAK,CAAC,GAAG,EAAE,IAAI,EAAE,GAAG,EAAE,CAAC,CAAC;IAC3C,CAAC;IAED,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IAEnC,OAAO;QACL,MAAM,EAAE,IAAI,CAAC,MAAM;QACnB,IAAI,EAAE,CAAC,GAAG,IAAI,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC;QACvD,MAAM,EAAE,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAC1D,GAAG,EAAE,IAAI,CAAC,CAAC,CAAC,EAAE,GAAG,IAAI,EAAE;KACxB,CAAC;AACJ,CAAC"}

package/dist/suggest.d.ts

@@ -0,0 +1,100 @@
+import type { Locale } from './i18n/types.js';
+import type { LlmProvider, TokenCounter } from './types.js';
+/**
+ * Rewrites the rules cannot do, proposed one phrase at a time.
+ *
+ * The existing LLM pass (`refineWithLlm`) hands the model the whole prompt and
+ * takes the whole answer back, which makes it all-or-nothing: when the result
+ * fails a safety check the author gets *nothing*, and when it passes they get a
+ * wholesale rewrite they have to read end to end to trust. Both halves of that
+ * are worse than they need to be.
+ *
+ * This asks a different question. "Which exact phrases in this prompt say
+ * something in more words than they need to?" — and the answer is a list of
+ * `before → after` pairs, each one small enough to judge on sight:
+ *
+ *     You should always make sure to  →  Always
+ *     It is important to note that    →  (removed)
+ *
+ * Nothing is applied unless the caller asks. Eight surviving suggestions out of
+ * ten is a useful result; a wholesale rewrite that fails one check is not.
+ *
+ * ## What makes a suggestion survive
+ *
+ * The model is a source of proposals, not of truth, so every one is checked
+ * against the prompt before it is shown:
+ *
+ * 1. **`before` must appear in the prompt, byte for byte.** A model that
+ *    paraphrases what it is quoting has invented a suggestion about text that
+ *    does not exist, and applying it would do nothing or, worse, match
+ *    something else.
+ * 2. **It must not touch protected content.** Code, URLs, placeholders and XML
+ *    tags are copied verbatim by every other part of this project, and a
+ *    suggestion that edits one is refused rather than negotiated.
+ * 3. **`after` must not introduce protected content.** A replacement that adds
+ *    a `{{placeholder}}` or a URL is proposing new semantics, not shorter
+ *    phrasing.
+ * 4. **It must actually save tokens.** A rephrasing that costs the same is a
+ *    change of style, and this tool is not a style guide.
+ * 5. **Overlapping suggestions are dropped, later ones first.** Applying two
+ *    edits that share characters produces text neither of them described.
+ */
+export interface RewriteSuggestion {
+    /** The exact text in the prompt, as it appears there. */
+    before: string;
+    /** What to put in its place. Empty means "delete this". */
+    after: string;
+    /** Character offsets in the prompt, one per surviving occurrence. */
+    offsets: number[];
+    /** Tokens saved if every occurrence is applied. */
+    tokensSaved: number;
+}
+export interface SuggestResult {
+    suggestions: RewriteSuggestion[];
+    /** Suggestions the model returned that did not survive, with the reason. */
+    rejected: Array<{
+        before: string;
+        after: string;
+        reason: RejectedReason;
+    }>;
+    provider: string;
+    model: string;
+}
+export type RejectedReason = 
+/** `before` is not in the prompt. The model paraphrased what it quoted. */
+'not-found'
+/** It would edit a code block, URL, placeholder or tag. */
+ | 'touches-protected'
+/** `after` introduces protected content that was not there. */
+ | 'introduces-protected'
+/** No shorter than what it replaces. */
+ | 'no-saving'
+/** It shares characters with a suggestion already accepted. */
+ | 'overlaps';
+export declare const SUGGEST_SYSTEM_PROMPT = "You find phrases in a prompt that say something in more words than they need.\n\nReturn ONLY a JSON array. Each element is {\"before\": \"...\", \"after\": \"...\"}.\n\nRules:\n- \"before\" MUST be copied character for character from the prompt. Do not paraphrase it, do not fix its punctuation, do not change its capitalisation. If you cannot copy it exactly, leave it out.\n- \"after\" says the same thing in fewer words. Use \"\" to delete the phrase entirely.\n- Preserve meaning exactly. Never change what the prompt asks for, its constraints, its output format or its success criteria.\n- Never touch code, URLs, template placeholders ({{x}}, ${x}, {x}) or XML/HTML tags \u2014 do not include them in \"before\" at all.\n- Keep the original language of the prompt.\n- Prefer a few high-value rewrites to many trivial ones. Return [] if there is nothing worth changing.\n\nNo explanation, no code fences, no commentary. The array alone.";
+export interface SuggestOptions {
+    tokenCounter?: TokenCounter;
+    locale?: Locale;
+    /** Cap on how many survive, highest saving first. Defaults to 20. */
+    max?: number;
+}
+/**
+ * Asks the provider for rewrites and returns the ones that survive checking.
+ *
+ * A provider that returns something unparseable yields an empty result rather
+ * than throwing: the deterministic rules have already run, and a malformed
+ * answer from an optional pass should cost the caller nothing.
+ */
+export declare function suggestRewrites(prompt: string, provider: LlmProvider, options?: SuggestOptions): Promise<SuggestResult>;
+/**
+ * Applies suggestions to the prompt.
+ *
+ * Right to left, so an earlier edit cannot move the offsets of a later one —
+ * the bug that makes every naive implementation of this corrupt long prompts,
+ * and one that shows up only when two suggestions are far enough apart that a
+ * short test never notices.
+ */
+export declare function applyRewrites(prompt: string, suggestions: readonly RewriteSuggestion[]): string;
+/** A reason code turned into a sentence, for a report. */
+export declare function rejectionText(reason: RejectedReason, locale: Locale): string;
+//# sourceMappingURL=suggest.d.ts.map

package/dist/suggest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"suggest.d.ts","sourceRoot":"","sources":["../src/suggest.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AAG9C,OAAO,KAAK,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE5D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG;AAEH,MAAM,WAAW,iBAAiB;IAChC,yDAAyD;IACzD,MAAM,EAAE,MAAM,CAAC;IACf,2DAA2D;IAC3D,KAAK,EAAE,MAAM,CAAC;IACd,qEAAqE;IACrE,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,mDAAmD;IACnD,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,aAAa;IAC5B,WAAW,EAAE,iBAAiB,EAAE,CAAC;IACjC,4EAA4E;IAC5E,QAAQ,EAAE,KAAK,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,cAAc,CAAA;KAAE,CAAC,CAAC;IAC3E,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,MAAM,cAAc;AACxB,2EAA2E;AACzE,WAAW;AACb,2DAA2D;GACzD,mBAAmB;AACrB,+DAA+D;GAC7D,sBAAsB;AACxB,wCAAwC;GACtC,WAAW;AACb,+DAA+D;GAC7D,UAAU,CAAC;AAEf,eAAO,MAAM,qBAAqB,k7BAY8B,CAAC;AAEjE,MAAM,WAAW,cAAc;IAC7B,YAAY,CAAC,EAAE,YAAY,CAAC;IAC5B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,qEAAqE;IACrE,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAwCD;;;;;;GAMG;AACH,wBAAsB,eAAe,CACnC,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,WAAW,EACrB,OAAO,GAAE,cAAmB,GAC3B,OAAO,CAAC,aAAa,CAAC,CAiFxB;AAED;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,SAAS,iBAAiB,EAAE,GAAG,MAAM,CAU/F;AAED,0DAA0D;AAC1D,wBAAgB,aAAa,CAAC,MAAM,EAAE,cAAc,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAE5E"}