@smeltjs/core 0.1.0

package/dist/cli/run.js

@@ -0,0 +1,351 @@
+import { readFileSync, statSync } from 'node:fs';
+import process from 'node:process';
+import { reconstruct } from '../apply.js';
+import { CliUsageError, SmeltError } from '../errors.js';
+import { createSmelter } from '../index.js';
+import { buildRepoMap } from '../repomap/map.js';
+import { MemoryElisionStore } from '../store.js';
+import { DirectoryElisionStore } from '../store-dir.js';
+import { CLI_NAME, cliUsage, parseSmeltArgs } from './args.js';
+import { loadNearestConfig } from './config.js';
+import { runInit } from './init.js';
+import { formatMapReport, formatReport } from './report.js';
+import { resolveMapRun, resolveRun, resolveStoreRun } from './resolve.js';
+export { CLI_NAME, cliUsage, parseSmeltArgs } from './args.js';
+export { formatMapReport, formatReport } from './report.js';
+export { resolveMapRun, resolveRun, resolveStoreRun } from './resolve.js';
+/**
+ * Exit codes, and why there are five of them.
+ *
+ * A CLI that returns 0 whatever happens is the shell-level version of a stub that
+ * returns `[]`: the caller cannot tell success from failure, so a pipeline built on it
+ * fails silently. **`overBudget` is the load-bearing one.** A plan that did not fit is
+ * not an error — smelt refused to cut the regions the caller asked to keep, which is
+ * correct — but it is also not success, and a script must be able to see the
+ * difference without parsing prose.
+ */
+export const EXIT = {
+    ok: 0,
+    overBudget: 1,
+    usage: 2,
+    refused: 3,
+    unexpected: 4,
+};
+/**
+ * The `--json` envelope format, versioned like the marker for the same reason: this is
+ * a surface other programs parse, so a change to it has to be identifiable rather than
+ * silent.
+ */
+export const CLI_JSON_FORMAT = 'smelt-cli/v1';
+/**
+ * The `smelt map --json` envelope format. Its own version line, because the two
+ * envelopes carry different structures and must be able to move independently —
+ * a map envelope has no elided bytes to carry, since a map elides nothing.
+ */
+export const CLI_MAP_JSON_FORMAT = 'smelt-map-cli/v1';
+/**
+ * The `smelt stats --json` envelope format. Its own version line for the same reason
+ * `smelt map` has one: the two envelopes carry different structures and must move
+ * independently.
+ */
+export const CLI_STATS_JSON_FORMAT = 'smelt-stats-cli/v1';
+/**
+ * The whole CLI, as a function that returns an exit code instead of calling `exit`.
+ *
+ * Smelted text goes to stdout and the report goes to stderr, so `smelt big.log
+ * --budget 4000 > small.log` leaves the human-readable part on the terminal and the
+ * payload in the file.
+ */
+export async function runCli(argv, io) {
+    try {
+        const invocation = parseSmeltArgs(argv);
+        switch (invocation.mode) {
+            case 'help':
+                io.stdout(cliUsage());
+                return EXIT.ok;
+            case 'version':
+                io.stdout(`${io.version}\n`);
+                return EXIT.ok;
+            case 'reconstruct':
+                return runReconstruct(readInput(invocation.file, io), io);
+            case 'init': {
+                if (io.initInput === undefined) {
+                    throw new CliUsageError(`${CLI_NAME}: init is interactive, and this invocation has no interactive ` +
+                        `input stream. Run \`${CLI_NAME} init\` from a terminal.`);
+                }
+                return await runInit({
+                    input: io.initInput,
+                    output: io.stdout,
+                    cwd: io.cwd ?? process.cwd(),
+                });
+            }
+            case 'smelt':
+                return await runSmelt(invocation, io);
+            case 'map':
+                return await runMap(invocation, io);
+            case 'retrieve':
+                return runRetrieve(invocation, io);
+            case 'stats':
+                return runStats(invocation, io);
+        }
+    }
+    catch (error) {
+        if (error instanceof CliUsageError) {
+            io.stderr(`${error.message}\n`);
+            return EXIT.usage;
+        }
+        if (error instanceof SmeltError) {
+            io.stderr(`${error.name}: ${error.message}\n`);
+            return EXIT.refused;
+        }
+        throw error;
+    }
+}
+/**
+ * One smelt run, executed straight-line over a {@link ResolvedRun}.
+ *
+ * All merging — flags versus `smelt.config.json` versus built-ins, including the
+ * budget-required refusal — happens in {@link resolveRun}, which is the only place
+ * precedence lives. This function reads the resolved object and never consults a flag
+ * or a config field directly.
+ */
+async function runSmelt(invocation, io) {
+    const run = resolveRun(invocation, loadNearestConfig(io.cwd ?? process.cwd()));
+    const inputText = readInput(run.file, io);
+    const source = run.file ?? '<stdin>';
+    const store = storeFor(run);
+    const smelter = createSmelter({
+        strategy: run.strategy,
+        ...(store === undefined ? {} : { store }),
+    });
+    const options = {
+        budgetBytes: run.budgetBytes,
+        ...(run.file === undefined ? {} : { path: run.file }),
+        ...(run.language === undefined ? {} : { language: run.language }),
+        ...(run.focus.length === 0 ? {} : { focus: run.focus }),
+    };
+    const result = await smelter.smelt(inputText, options);
+    if (run.json) {
+        io.stdout(`${JSON.stringify(envelope(result, smelter.store), null, 2)}\n`);
+    }
+    else {
+        io.stdout(result.text);
+    }
+    io.stderr(formatReport({ result, source, budgetBytes: run.budgetBytes, inputText }));
+    return result.outputBytes > run.budgetBytes ? EXIT.overBudget : EXIT.ok;
+}
+/**
+ * One `smelt map` run, executed straight-line over a {@link ResolvedMapRun} the same
+ * way {@link runSmelt} executes its {@link ResolvedRun} — the merge, including the
+ * budget-required refusal, lives in {@link resolveMapRun}.
+ *
+ * The map is deliberately **not** served through a planner strategy: `buildRepoMap`
+ * returns a {@link RepoMap}, not an `ElisionPlan` — nothing is elided, stored, or
+ * reversible — so it gets its own subcommand and its own envelope instead of a
+ * `--strategy` name that would lie about what comes back. And the exit code is
+ * {@link EXIT.ok} on every successful build: `EXIT.overBudget` exists because a smelt
+ * plan may refuse to cut kept regions and come back too big, while the map fits
+ * itself to the budget by construction — an over-budget map cannot happen, so no
+ * exit code pretends it can.
+ */
+async function runMap(invocation, io) {
+    const run = resolveMapRun(invocation, loadNearestConfig(io.cwd ?? process.cwd()));
+    assertDirectory(run.dir);
+    const map = await buildRepoMap({
+        root: run.dir,
+        budgetBytes: run.budgetBytes,
+        ...(run.focus.length === 0 ? {} : { focus: run.focus }),
+        ...(run.ignore === undefined ? {} : { ignore: run.ignore }),
+        ...(run.cacheDir === undefined ? {} : { cacheDir: run.cacheDir }),
+    });
+    if (run.json) {
+        const mapEnvelope = { format: CLI_MAP_JSON_FORMAT, map };
+        io.stdout(`${JSON.stringify(mapEnvelope, null, 2)}\n`);
+    }
+    else {
+        io.stdout(map.text);
+    }
+    io.stderr(formatMapReport({ map, source: run.dir, budgetSource: run.budgetSource }));
+    return EXIT.ok;
+}
+/** A directory the walk can start from, or a usage error naming what is wrong. */
+function assertDirectory(dir) {
+    let isDirectory;
+    try {
+        isDirectory = statSync(dir).isDirectory();
+    }
+    catch (cause) {
+        throw new CliUsageError(`${CLI_NAME}: cannot read directory "${dir}": ` +
+            `${cause instanceof Error ? cause.message : String(cause)}`);
+    }
+    if (!isDirectory) {
+        throw new CliUsageError(`${CLI_NAME}: "${dir}" is not a directory. map reads a whole tree; for one ` +
+            `file, use \`${CLI_NAME} <file>\`.`);
+    }
+}
+/**
+ * Construct the store a {@link ResolvedRun} decided on, or `undefined` for the
+ * library's own default (a fresh in-memory store). Pure construction — the decision,
+ * including path resolution, was already made in {@link resolveRun}.
+ */
+function storeFor(run) {
+    if (run.store.kind === 'memory')
+        return undefined;
+    return new DirectoryElisionStore(run.store.path);
+}
+/**
+ * `smelt retrieve <hash>` — the marker's `retrieve("hash")`, as a real command.
+ *
+ * The exact original bytes go to stdout and **nothing else does**: no report, no
+ * trailing newline the store did not hold, no re-encoding. Trailing-newline fidelity
+ * is not pedantry — the retrieved bytes get spliced back into reasoning about the
+ * original, and an almost-right blob is the silent wrong answer this project refuses.
+ *
+ * The retrieval IS counted — that is the point. `store.retrieve()` journals the hit,
+ * so an agent working from pure shell moves the same `expansionRate` a tool-calling
+ * consumer moves, and over-pruning stays visible whichever loop is in use. Errors are
+ * the store's own, verbatim: `UnknownHashError` for a hash never elided,
+ * `StoreCorruptionError` for bytes that no longer hash to their name — distinct
+ * texts, both exiting {@link EXIT.refused}.
+ */
+function runRetrieve(invocation, io) {
+    const run = resolveStoreRun('retrieve', loadNearestConfig(io.cwd ?? process.cwd()));
+    const store = new DirectoryElisionStore(run.storePath);
+    const content = store.retrieve(invocation.hash);
+    io.stdout(content);
+    return EXIT.ok;
+}
+/**
+ * `smelt stats` — the store's counters, without touching them.
+ *
+ * Reading stats does NOT count as a retrieval: `stats()` folds the journal and scans
+ * the blobs, journaling nothing, so watching the expansion rate can never move it —
+ * an observer that inflated its own metric would make the honest signal dishonest.
+ *
+ * The plain form is one `name value` per line, greppable and stable; `--json` emits
+ * the {@link RetrieveStats} verbatim in its own versioned envelope
+ * ({@link CLI_STATS_JSON_FORMAT}), like every other machine-read surface here.
+ */
+function runStats(invocation, io) {
+    const run = resolveStoreRun('stats', loadNearestConfig(io.cwd ?? process.cwd()));
+    const stats = new DirectoryElisionStore(run.storePath).stats();
+    if (invocation.json) {
+        const statsEnvelope = { format: CLI_STATS_JSON_FORMAT, stats };
+        io.stdout(`${JSON.stringify(statsEnvelope, null, 2)}\n`);
+        return EXIT.ok;
+    }
+    io.stdout([
+        `elisionsStored ${String(stats.elisionsStored)}`,
+        `bytesStored ${String(stats.bytesStored)}`,
+        `retrieveCalls ${String(stats.retrieveCalls)}`,
+        `uniqueRetrieved ${String(stats.uniqueRetrieved)}`,
+        `expansionRate ${String(stats.expansionRate)}`,
+        `allElisionsRetrieved ${String(stats.allElisionsRetrieved)}`,
+        '',
+    ].join('\n'));
+    return EXIT.ok;
+}
+/**
+ * Law 3, from a shell.
+ *
+ * This is deliberately not "print the text and hope": it rebuilds the store from the
+ * envelope, checks every hash against the bytes it claims to key, and checks the
+ * reconstructed length against the `inputBytes` the result recorded at the time of the
+ * cut. A round trip that quietly returns almost-right text is the failure this whole
+ * repository is arranged against.
+ */
+function runReconstruct(text, io) {
+    const { result, elided } = parseEnvelope(text);
+    const store = new MemoryElisionStore();
+    for (const [hash, content] of Object.entries(elided)) {
+        const actual = store.put(content);
+        if (actual !== hash) {
+            throw new CliUsageError(`${CLI_NAME}: envelope is not self-consistent — it stores bytes under ` +
+                `"${hash}" that actually hash to "${actual}". Refusing to reconstruct from it.`);
+        }
+    }
+    for (const elision of result.elisions) {
+        if (!store.has(elision.hash)) {
+            throw new CliUsageError(`${CLI_NAME}: envelope is missing the bytes for "${elision.hash}". A result ` +
+                `without its elided bytes cannot be reconstructed; re-run with --json.`);
+        }
+    }
+    const original = reconstruct(result, store);
+    const bytes = Buffer.byteLength(original, 'utf8');
+    if (bytes !== result.inputBytes) {
+        throw new SmeltError(`${CLI_NAME}: reconstruction produced ${String(bytes)} bytes but the result ` +
+            `recorded ${String(result.inputBytes)}. The round trip did not close.`);
+    }
+    io.stdout(original);
+    io.stderr(`${CLI_NAME}  reconstructed ${String(result.inputBytes)} B from ` +
+        `${String(result.elisions.length)} elisions — byte for byte\n`);
+    return EXIT.ok;
+}
+/** `peek`, not `retrieve`: writing a file is not the model asking for anything back. */
+function envelope(result, store) {
+    const elided = {};
+    for (const elision of result.elisions) {
+        const content = store.peek(elision.hash);
+        if (content === undefined) {
+            throw new SmeltError(`${CLI_NAME}: the store does not hold "${elision.hash}", which its own result ` +
+                `says it elided. Refusing to write an envelope that cannot round-trip.`);
+        }
+        elided[elision.hash] = content;
+    }
+    return { format: CLI_JSON_FORMAT, result, elided };
+}
+function parseEnvelope(text) {
+    let value;
+    try {
+        value = JSON.parse(text);
+    }
+    catch (cause) {
+        throw new CliUsageError(`${CLI_NAME}: --reconstruct expected a --json envelope, and this is not JSON: ` +
+            `${cause instanceof Error ? cause.message : String(cause)}`);
+    }
+    if (typeof value !== 'object' || value === null) {
+        throw new CliUsageError(`${CLI_NAME}: --reconstruct expected a JSON object.`);
+    }
+    const fields = value;
+    if (fields['format'] !== CLI_JSON_FORMAT) {
+        throw new CliUsageError(`${CLI_NAME}: this envelope says format "${String(fields['format'])}"; this build ` +
+            `reads "${CLI_JSON_FORMAT}". Formats are versioned so a mismatch is visible ` +
+            `instead of being half-understood.`);
+    }
+    const result = fields['result'];
+    if (typeof result !== 'object' || result === null) {
+        throw new CliUsageError(`${CLI_NAME}: envelope has no \`result\` object.`);
+    }
+    const resultFields = result;
+    if (typeof resultFields['text'] !== 'string' ||
+        typeof resultFields['inputBytes'] !== 'number' ||
+        !Array.isArray(resultFields['elisions'])) {
+        throw new CliUsageError(`${CLI_NAME}: envelope's \`result\` is missing text, inputBytes or elisions.`);
+    }
+    const elided = fields['elided'];
+    if (typeof elided !== 'object' || elided === null) {
+        throw new CliUsageError(`${CLI_NAME}: envelope has no \`elided\` map.`);
+    }
+    for (const [hash, content] of Object.entries(elided)) {
+        if (typeof content !== 'string') {
+            throw new CliUsageError(`${CLI_NAME}: envelope's \`elided["${hash}"]\` is not a string.`);
+        }
+    }
+    return {
+        format: CLI_JSON_FORMAT,
+        result: result,
+        elided: elided,
+    };
+}
+function readInput(file, io) {
+    if (file === undefined)
+        return io.stdin();
+    try {
+        return readFileSync(file, 'utf8');
+    }
+    catch (cause) {
+        throw new CliUsageError(`${CLI_NAME}: cannot read "${file}": ` +
+            `${cause instanceof Error ? cause.message : String(cause)}`);
+    }
+}
+//# sourceMappingURL=run.js.map

package/dist/cli/run.js.map

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

package/dist/detect.d.ts

@@ -0,0 +1,16 @@
+import type { DetectedLanguage, LanguageId } from './types.ts';
+/**
+ * Every language smelt has a grammar mapping for — the registry's ids, in registry
+ * order. A derived view of `LANGUAGE_PROFILES`, kept as an export because tests and
+ * the CLI's rendered lists read it.
+ */
+export declare const SUPPORTED_LANGUAGES: readonly LanguageId[];
+/**
+ * Detect the language of a path, from its extension. Returns `'unknown'` for anything
+ * unmapped — which is a normal outcome, not an error: it selects the lexical planner,
+ * which works on anything. The extension → profile mapping itself lives on each
+ * language's `LanguageProfile` (`src/lang/`); this is the id-shaped view of
+ * {@link profileForPath}.
+ */
+export declare function detectLanguage(path: string | undefined): DetectedLanguage;
+//# sourceMappingURL=detect.d.ts.map

package/dist/detect.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"detect.d.ts","sourceRoot":"","sources":["../src/detect.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAE/D;;;;GAIG;AACH,eAAO,MAAM,mBAAmB,EAAE,SAAS,UAAU,EAEpD,CAAC;AAEF;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,gBAAgB,CAEzE"}

package/dist/detect.js

@@ -0,0 +1,18 @@
+import { LANGUAGE_PROFILES, profileForPath } from './lang/registry.js';
+/**
+ * Every language smelt has a grammar mapping for — the registry's ids, in registry
+ * order. A derived view of `LANGUAGE_PROFILES`, kept as an export because tests and
+ * the CLI's rendered lists read it.
+ */
+export const SUPPORTED_LANGUAGES = Object.values(LANGUAGE_PROFILES).map((profile) => profile.id);
+/**
+ * Detect the language of a path, from its extension. Returns `'unknown'` for anything
+ * unmapped — which is a normal outcome, not an error: it selects the lexical planner,
+ * which works on anything. The extension → profile mapping itself lives on each
+ * language's `LanguageProfile` (`src/lang/`); this is the id-shaped view of
+ * {@link profileForPath}.
+ */
+export function detectLanguage(path) {
+    return profileForPath(path)?.id ?? 'unknown';
+}
+//# sourceMappingURL=detect.js.map

package/dist/detect.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"detect.js","sourceRoot":"","sources":["../src/detect.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAGvE;;;;GAIG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAA0B,MAAM,CAAC,MAAM,CAAC,iBAAiB,CAAC,CAAC,GAAG,CAC5F,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,EAAE,CACxB,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,UAAU,cAAc,CAAC,IAAwB;IACrD,OAAO,cAAc,CAAC,IAAI,CAAC,EAAE,EAAE,IAAI,SAAS,CAAC;AAC/C,CAAC"}

package/dist/errors.d.ts

@@ -0,0 +1,88 @@
+/**
+ * Every error smelt throws is one of these. Consumers can `instanceof SmeltError`
+ * to tell "the library said no" apart from "something else blew up".
+ */
+export declare class SmeltError extends Error {
+    readonly name: string;
+}
+/**
+ * A scaffold stub. It throws instead of returning a plausible-looking wrong answer,
+ * because a context optimizer that quietly returns bad output is indistinguishable
+ * from one that works. See CONTRIBUTING.md § "Silence is the enemy".
+ */
+export declare class NotImplementedError extends SmeltError {
+    readonly name = "NotImplementedError";
+    constructor(what: string, seeAlso: string);
+}
+/**
+ * Thrown when something in the elision path tried to reach a non-local resource.
+ * v1 has no network. See docs/HANDOFF.md § "Law 1 — zero network".
+ */
+export declare class NetworkPolicyError extends SmeltError {
+    readonly name = "NetworkPolicyError";
+    constructor(message: string);
+}
+/** A plan asked to elide two overlapping ranges. Applying it would corrupt the output. */
+export declare class OverlappingElisionError extends SmeltError {
+    readonly name = "OverlappingElisionError";
+}
+/** A plan referenced a byte range that is not inside the input. */
+export declare class RangeOutOfBoundsError extends SmeltError {
+    readonly name = "RangeOutOfBoundsError";
+}
+/** A grammar was requested that is not installed or not registered. */
+export declare class GrammarUnavailableError extends SmeltError {
+    readonly name = "GrammarUnavailableError";
+}
+/** `retrieve(hash)` was called with a hash the store does not hold. */
+export declare class UnknownHashError extends SmeltError {
+    readonly name = "UnknownHashError";
+    constructor(hash: string);
+}
+/**
+ * A planner was handed a `PlanInput` without `pricing`. The type makes `pricing`
+ * required, so TypeScript callers cannot get here; a JS caller can, and the honest
+ * answer is this error rather than a guessed marker cost — a planner pricing markers
+ * itself is exactly the inversion the MarkerPricing seam removed.
+ */
+export declare class MissingMarkerPricingError extends SmeltError {
+    readonly name = "MissingMarkerPricingError";
+    constructor(plannerId: string);
+}
+/**
+ * The CLI was invoked wrongly — a missing `--budget`, an unknown flag, a budget that
+ * is not a number. Distinct from every other `SmeltError` so the CLI can exit with a
+ * usage code rather than pretending the library refused.
+ */
+export declare class CliUsageError extends SmeltError {
+    readonly name = "CliUsageError";
+}
+/**
+ * Two different blobs hashed to the same key. Astronomically unlikely, and yet: the
+ * alternative to throwing is handing the model the wrong bytes and calling it a
+ * retrieval, which is precisely the silent failure this library exists to avoid.
+ */
+export declare class HashCollisionError extends SmeltError {
+    readonly name = "HashCollisionError";
+    constructor(hash: string);
+}
+/**
+ * A persistent store holds bytes under this hash, but they no longer hash to it — a
+ * torn write, a truncation, an edit behind the store's back. Deliberately distinct from
+ * {@link UnknownHashError}: "we hold damaged bytes" and "never existed" call for
+ * different responses, and returning the damaged bytes as a retrieval would be the
+ * silent wrong answer this library exists to refuse.
+ */
+export declare class StoreCorruptionError extends SmeltError {
+    readonly name = "StoreCorruptionError";
+    constructor(hash: string);
+}
+/**
+ * A directory offered as a persistent store carries a format marker this version of
+ * smelt does not understand — or no parseable marker at all. Refusing beats guessing:
+ * reinterpreting an unknown layout could hand back the wrong bytes with no error.
+ */
+export declare class StoreFormatError extends SmeltError {
+    readonly name = "StoreFormatError";
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,qBAAa,UAAW,SAAQ,KAAK;IACnC,SAAkB,IAAI,EAAE,MAAM,CAAgB;CAC/C;AAED;;;;GAIG;AACH,qBAAa,mBAAoB,SAAQ,UAAU;IACjD,SAAkB,IAAI,yBAAyB;IAE/C,YAAY,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAKxC;CACF;AAED;;;GAGG;AACH,qBAAa,kBAAmB,SAAQ,UAAU;IAChD,SAAkB,IAAI,wBAAwB;IAE9C,YAAY,OAAO,EAAE,MAAM,EAE1B;CACF;AAED,0FAA0F;AAC1F,qBAAa,uBAAwB,SAAQ,UAAU;IACrD,SAAkB,IAAI,6BAA6B;CACpD;AAED,mEAAmE;AACnE,qBAAa,qBAAsB,SAAQ,UAAU;IACnD,SAAkB,IAAI,2BAA2B;CAClD;AAED,uEAAuE;AACvE,qBAAa,uBAAwB,SAAQ,UAAU;IACrD,SAAkB,IAAI,6BAA6B;CACpD;AAED,uEAAuE;AACvE,qBAAa,gBAAiB,SAAQ,UAAU;IAC9C,SAAkB,IAAI,sBAAsB;IAE5C,YAAY,IAAI,EAAE,MAAM,EAIvB;CACF;AAED;;;;;GAKG;AACH,qBAAa,yBAA0B,SAAQ,UAAU;IACvD,SAAkB,IAAI,+BAA+B;IAErD,YAAY,SAAS,EAAE,MAAM,EAO5B;CACF;AAED;;;;GAIG;AACH,qBAAa,aAAc,SAAQ,UAAU;IAC3C,SAAkB,IAAI,mBAAmB;CAC1C;AAED;;;;GAIG;AACH,qBAAa,kBAAmB,SAAQ,UAAU;IAChD,SAAkB,IAAI,wBAAwB;IAE9C,YAAY,IAAI,EAAE,MAAM,EAKvB;CACF;AAED;;;;;;GAMG;AACH,qBAAa,oBAAqB,SAAQ,UAAU;IAClD,SAAkB,IAAI,0BAA0B;IAEhD,YAAY,IAAI,EAAE,MAAM,EAMvB;CACF;AAED;;;;GAIG;AACH,qBAAa,gBAAiB,SAAQ,UAAU;IAC9C,SAAkB,IAAI,sBAAsB;CAC7C"}

package/dist/errors.js

@@ -0,0 +1,107 @@
+/**
+ * Every error smelt throws is one of these. Consumers can `instanceof SmeltError`
+ * to tell "the library said no" apart from "something else blew up".
+ */
+export class SmeltError extends Error {
+    name = 'SmeltError';
+}
+/**
+ * A scaffold stub. It throws instead of returning a plausible-looking wrong answer,
+ * because a context optimizer that quietly returns bad output is indistinguishable
+ * from one that works. See CONTRIBUTING.md § "Silence is the enemy".
+ */
+export class NotImplementedError extends SmeltError {
+    name = 'NotImplementedError';
+    constructor(what, seeAlso) {
+        super(`smelt: ${what} is not implemented yet. This is a scaffold stub — it throws rather ` +
+            `than returning a plausible wrong answer. See ${seeAlso}.`);
+    }
+}
+/**
+ * Thrown when something in the elision path tried to reach a non-local resource.
+ * v1 has no network. See docs/HANDOFF.md § "Law 1 — zero network".
+ */
+export class NetworkPolicyError extends SmeltError {
+    name = 'NetworkPolicyError';
+    constructor(message) {
+        super(`smelt: ${message}`);
+    }
+}
+/** A plan asked to elide two overlapping ranges. Applying it would corrupt the output. */
+export class OverlappingElisionError extends SmeltError {
+    name = 'OverlappingElisionError';
+}
+/** A plan referenced a byte range that is not inside the input. */
+export class RangeOutOfBoundsError extends SmeltError {
+    name = 'RangeOutOfBoundsError';
+}
+/** A grammar was requested that is not installed or not registered. */
+export class GrammarUnavailableError extends SmeltError {
+    name = 'GrammarUnavailableError';
+}
+/** `retrieve(hash)` was called with a hash the store does not hold. */
+export class UnknownHashError extends SmeltError {
+    name = 'UnknownHashError';
+    constructor(hash) {
+        super(`smelt: no stored content for hash "${hash}". It was never elided, or the store was reset.`);
+    }
+}
+/**
+ * A planner was handed a `PlanInput` without `pricing`. The type makes `pricing`
+ * required, so TypeScript callers cannot get here; a JS caller can, and the honest
+ * answer is this error rather than a guessed marker cost — a planner pricing markers
+ * itself is exactly the inversion the MarkerPricing seam removed.
+ */
+export class MissingMarkerPricingError extends SmeltError {
+    name = 'MissingMarkerPricingError';
+    constructor(plannerId) {
+        super(`smelt: ${plannerId} was handed a PlanInput without \`pricing\`. A planner never ` +
+            `guesses what a marker costs — the applier renders markers, so the applier ` +
+            `prices them. Build one with markerPricing(language, marker) from apply.ts and ` +
+            `put it on the input; createSmelter and the CLI construct it centrally.`);
+    }
+}
+/**
+ * The CLI was invoked wrongly — a missing `--budget`, an unknown flag, a budget that
+ * is not a number. Distinct from every other `SmeltError` so the CLI can exit with a
+ * usage code rather than pretending the library refused.
+ */
+export class CliUsageError extends SmeltError {
+    name = 'CliUsageError';
+}
+/**
+ * Two different blobs hashed to the same key. Astronomically unlikely, and yet: the
+ * alternative to throwing is handing the model the wrong bytes and calling it a
+ * retrieval, which is precisely the silent failure this library exists to avoid.
+ */
+export class HashCollisionError extends SmeltError {
+    name = 'HashCollisionError';
+    constructor(hash) {
+        super(`smelt: hash collision on "${hash}" — two different blobs share a key. Refusing to ` +
+            `store, because retrieving would return the wrong bytes. Please report this.`);
+    }
+}
+/**
+ * A persistent store holds bytes under this hash, but they no longer hash to it — a
+ * torn write, a truncation, an edit behind the store's back. Deliberately distinct from
+ * {@link UnknownHashError}: "we hold damaged bytes" and "never existed" call for
+ * different responses, and returning the damaged bytes as a retrieval would be the
+ * silent wrong answer this library exists to refuse.
+ */
+export class StoreCorruptionError extends SmeltError {
+    name = 'StoreCorruptionError';
+    constructor(hash) {
+        super(`smelt: the bytes stored under hash "${hash}" do not hash to "${hash}". Refusing ` +
+            `to return them — they are damaged, not merely unknown. The store directory was ` +
+            `truncated or edited outside smelt.`);
+    }
+}
+/**
+ * A directory offered as a persistent store carries a format marker this version of
+ * smelt does not understand — or no parseable marker at all. Refusing beats guessing:
+ * reinterpreting an unknown layout could hand back the wrong bytes with no error.
+ */
+export class StoreFormatError extends SmeltError {
+    name = 'StoreFormatError';
+}
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,OAAO,UAAW,SAAQ,KAAK;IACjB,IAAI,GAAW,YAAY,CAAC;CAC/C;AAED;;;;GAIG;AACH,MAAM,OAAO,mBAAoB,SAAQ,UAAU;IAC/B,IAAI,GAAG,qBAAqB,CAAC;IAE/C,YAAY,IAAY,EAAE,OAAe;QACvC,KAAK,CACH,UAAU,IAAI,sEAAsE;YAClF,gDAAgD,OAAO,GAAG,CAC7D,CAAC;IACJ,CAAC;CACF;AAED;;;GAGG;AACH,MAAM,OAAO,kBAAmB,SAAQ,UAAU;IAC9B,IAAI,GAAG,oBAAoB,CAAC;IAE9C,YAAY,OAAe;QACzB,KAAK,CAAC,UAAU,OAAO,EAAE,CAAC,CAAC;IAC7B,CAAC;CACF;AAED,0FAA0F;AAC1F,MAAM,OAAO,uBAAwB,SAAQ,UAAU;IACnC,IAAI,GAAG,yBAAyB,CAAC;CACpD;AAED,mEAAmE;AACnE,MAAM,OAAO,qBAAsB,SAAQ,UAAU;IACjC,IAAI,GAAG,uBAAuB,CAAC;CAClD;AAED,uEAAuE;AACvE,MAAM,OAAO,uBAAwB,SAAQ,UAAU;IACnC,IAAI,GAAG,yBAAyB,CAAC;CACpD;AAED,uEAAuE;AACvE,MAAM,OAAO,gBAAiB,SAAQ,UAAU;IAC5B,IAAI,GAAG,kBAAkB,CAAC;IAE5C,YAAY,IAAY;QACtB,KAAK,CACH,sCAAsC,IAAI,iDAAiD,CAC5F,CAAC;IACJ,CAAC;CACF;AAED;;;;;GAKG;AACH,MAAM,OAAO,yBAA0B,SAAQ,UAAU;IACrC,IAAI,GAAG,2BAA2B,CAAC;IAErD,YAAY,SAAiB;QAC3B,KAAK,CACH,UAAU,SAAS,+DAA+D;YAChF,4EAA4E;YAC5E,gFAAgF;YAChF,wEAAwE,CAC3E,CAAC;IACJ,CAAC;CACF;AAED;;;;GAIG;AACH,MAAM,OAAO,aAAc,SAAQ,UAAU;IACzB,IAAI,GAAG,eAAe,CAAC;CAC1C;AAED;;;;GAIG;AACH,MAAM,OAAO,kBAAmB,SAAQ,UAAU;IAC9B,IAAI,GAAG,oBAAoB,CAAC;IAE9C,YAAY,IAAY;QACtB,KAAK,CACH,6BAA6B,IAAI,mDAAmD;YAClF,6EAA6E,CAChF,CAAC;IACJ,CAAC;CACF;AAED;;;;;;GAMG;AACH,MAAM,OAAO,oBAAqB,SAAQ,UAAU;IAChC,IAAI,GAAG,sBAAsB,CAAC;IAEhD,YAAY,IAAY;QACtB,KAAK,CACH,uCAAuC,IAAI,qBAAqB,IAAI,cAAc;YAChF,iFAAiF;YACjF,oCAAoC,CACvC,CAAC;IACJ,CAAC;CACF;AAED;;;;GAIG;AACH,MAAM,OAAO,gBAAiB,SAAQ,UAAU;IAC5B,IAAI,GAAG,kBAAkB,CAAC;CAC7C"}

package/dist/hash.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Length of the hex digest smelt uses as a retrieval key.
+ *
+ * The hash goes into every marker, so the model pays for it in tokens on every
+ * elision. 16 hex characters is 64 bits — plenty for the number of elisions one
+ * session produces, and cheap enough to inline. The store still verifies content on
+ * collision rather than trusting the digest, so shortening it is a token decision,
+ * not a correctness one.
+ */
+export declare const HASH_LENGTH = 16;
+/** Content hash of a string, over its UTF-8 bytes. Stable across runs and platforms. */
+export declare function contentHash(content: string): string;
+//# sourceMappingURL=hash.d.ts.map

package/dist/hash.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hash.d.ts","sourceRoot":"","sources":["../src/hash.ts"],"names":[],"mappings":"AAEA;;;;;;;;GAQG;AACH,eAAO,MAAM,WAAW,KAAK,CAAC;AAE9B,wFAAwF;AACxF,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAEnD"}

package/dist/hash.js

@@ -0,0 +1,16 @@
+import { createHash } from 'node:crypto';
+/**
+ * Length of the hex digest smelt uses as a retrieval key.
+ *
+ * The hash goes into every marker, so the model pays for it in tokens on every
+ * elision. 16 hex characters is 64 bits — plenty for the number of elisions one
+ * session produces, and cheap enough to inline. The store still verifies content on
+ * collision rather than trusting the digest, so shortening it is a token decision,
+ * not a correctness one.
+ */
+export const HASH_LENGTH = 16;
+/** Content hash of a string, over its UTF-8 bytes. Stable across runs and platforms. */
+export function contentHash(content) {
+    return createHash('sha256').update(content, 'utf8').digest('hex').slice(0, HASH_LENGTH);
+}
+//# sourceMappingURL=hash.js.map

package/dist/hash.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hash.js","sourceRoot":"","sources":["../src/hash.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG,EAAE,CAAC;AAE9B,wFAAwF;AACxF,MAAM,UAAU,WAAW,CAAC,OAAe;IACzC,OAAO,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,WAAW,CAAC,CAAC;AAC1F,CAAC"}