@trazum/core 1.8.0

package/dist/config-schema.js

@@ -0,0 +1,315 @@
+import { BASELINE_FILENAME } from './baseline.js';
+import { mostSpecificMatch } from './glob.js';
+import { isLocale } from './i18n/index.js';
+import { nearestName } from './nearest.js';
+import { RULES } from './rules.js';
+/**
+ * The shape and validation of `trazum.config.json`. No filesystem access — the
+ * loader that reads the file lives in `config.ts`, which is only reachable via
+ * `@trazum/core/node`. Keeping the schema pure is what lets the browser bundle
+ * import the types and key lists without dragging `node:fs` into its graph.
+ *
+ * The problem this solves is small and real: every command in a repository's CI
+ * repeats the same four flags, and the one place they get out of step is the
+ * place the numbers stop meaning anything.
+ *
+ * **Every validation failure here throws.** That is the whole design. A config
+ * file is trusted to carry a budget, and the failure mode of a lenient parser
+ * is a typo'd key silently ignored, defaults quietly restored, and a green
+ * build for a prompt nobody measured. An unreadable config is a loud error; a
+ * config that half-applies is a lie.
+ */
+export const CONFIG_FILENAME = 'trazum.config.json';
+/**
+ * Largest config file this will read.
+ *
+ * A config is a couple of dozen lines. This exists so a hostile or accidental
+ * multi-megabyte file is refused before `JSON.parse` is handed the whole thing.
+ */
+export const MAX_CONFIG_BYTES = 64 * 1024;
+/** How far up the tree the search for a config file will walk. */
+export const MAX_CONFIG_SEARCH_DEPTH = 32;
+/**
+ * Every key the config accepts. Exported so the CLI's help can be tested
+ * against it rather than against a second hand-maintained list — a setting the
+ * help never mentions is one only the changelog knows about.
+ */
+export const CONFIG_KEYS = [
+    'level',
+    'locale',
+    'disable',
+    'usage',
+    'budgets',
+    'maxGrowth',
+    'baseline',
+    'extensions',
+    'pricing',
+];
+export const CONFIG_BASELINE_KEYS = ['path', 'maxGrowthTokens', 'maxGrowthPct'];
+export const CONFIG_USAGE_KEYS = [
+    'model',
+    'callsPerMonth',
+    'avgOutputTokens',
+    'cacheHitRate',
+    'batchEligible',
+];
+const TOP_LEVEL_KEYS = CONFIG_KEYS;
+const USAGE_KEYS = CONFIG_USAGE_KEYS;
+/** Extensions directory mode reads when the config does not say otherwise. */
+export const DEFAULT_EXTENSIONS = ['.txt', '.md', '.prompt', '.tmpl'];
+export class ConfigError extends Error {
+    source;
+    constructor(message, source) {
+        super(`${source}: ${message}`);
+        this.source = source;
+        this.name = 'ConfigError';
+    }
+}
+const isPlainObject = (value) => typeof value === 'object' && value !== null && !Array.isArray(value);
+/**
+ * Rejects a key the schema does not have, naming the nearest one that it does.
+ *
+ * This is the same failure as an unrecognised CLI flag, and it gets the same
+ * treatment for the same reason: `"maxtokens"` where the schema says `budgets`
+ * is a budget that is never read, and silence about it means CI stays green.
+ */
+function rejectUnknownKeys(object, allowed, source, path) {
+    for (const key of Object.keys(object)) {
+        if (allowed.includes(key))
+            continue;
+        const nearest = nearestName(key, allowed);
+        throw new ConfigError(nearest
+            ? `unknown key "${path}${key}" — did you mean "${nearest}"?`
+            : `unknown key "${path}${key}". Known keys: ${allowed.join(', ')}`, source);
+    }
+}
+function requireNonNegativeNumber(value, label, source) {
+    if (typeof value !== 'number' || !Number.isFinite(value) || value < 0) {
+        throw new ConfigError(`"${label}" must be a number of 0 or more`, source);
+    }
+    return value;
+}
+function parseUsage(raw, source) {
+    if (!isPlainObject(raw))
+        throw new ConfigError('"usage" must be an object', source);
+    rejectUnknownKeys(raw, USAGE_KEYS, source, 'usage.');
+    const usage = {};
+    if (raw.model !== undefined) {
+        if (typeof raw.model !== 'string' || raw.model.trim() === '') {
+            throw new ConfigError('"usage.model" must be a non-empty string', source);
+        }
+        // Deliberately NOT checked against the catalogue here. A `pricing` overlay can
+        // introduce a model, and the path to that overlay is a key of this very
+        // document — so the parser cannot know the catalogue yet. The membership check
+        // happens in `loadConfig`, once the overlay has been resolved, which is the
+        // only place with enough information to be right about it.
+        usage.model = raw.model;
+    }
+    if (raw.callsPerMonth !== undefined) {
+        usage.callsPerMonth = requireNonNegativeNumber(raw.callsPerMonth, 'usage.callsPerMonth', source);
+    }
+    if (raw.avgOutputTokens !== undefined) {
+        usage.avgOutputTokens = requireNonNegativeNumber(raw.avgOutputTokens, 'usage.avgOutputTokens', source);
+    }
+    if (raw.cacheHitRate !== undefined) {
+        const rate = requireNonNegativeNumber(raw.cacheHitRate, 'usage.cacheHitRate', source);
+        if (rate > 1) {
+            throw new ConfigError('"usage.cacheHitRate" is a fraction between 0 and 1', source);
+        }
+        usage.cacheHitRate = rate;
+    }
+    if (raw.batchEligible !== undefined) {
+        if (typeof raw.batchEligible !== 'boolean') {
+            throw new ConfigError('"usage.batchEligible" must be true or false', source);
+        }
+        usage.batchEligible = raw.batchEligible;
+    }
+    return usage;
+}
+/**
+ * An absolute path, in any of the shapes a config file might carry one.
+ *
+ * Written out rather than delegating to `path.isAbsolute` for two reasons. It
+ * keeps `node:path` out of this module — the browser bundle imports it, and a
+ * Node builtin anywhere in that graph fails the web build. And `isAbsolute` is
+ * platform-dependent: on Linux it reads `C:\prompts` as relative, so a pattern
+ * written on Windows would pass validation on a Linux CI runner and then match
+ * nothing. A config should be judged the same way everywhere it is checked.
+ */
+const IS_ABSOLUTE = /^(?:[/\\]|[A-Za-z]:[/\\])/;
+function parseBudgets(raw, source) {
+    if (!isPlainObject(raw))
+        throw new ConfigError('"budgets" must be an object', source);
+    const budgets = {};
+    for (const [pattern, value] of Object.entries(raw)) {
+        if (pattern.length === 0) {
+            throw new ConfigError('"budgets" has an empty pattern', source);
+        }
+        if (IS_ABSOLUTE.test(pattern) || pattern.includes('..')) {
+            // Budgets key files inside the repository. An absolute pattern, or one
+            // that climbs out with "..", either matches nothing or matches something
+            // outside the project — both are mistakes worth naming.
+            throw new ConfigError(`budget pattern "${pattern}" must be a relative path inside the project`, source);
+        }
+        const tokens = requireNonNegativeNumber(value, `budgets["${pattern}"]`, source);
+        if (!Number.isInteger(tokens)) {
+            throw new ConfigError(`budgets["${pattern}"] must be a whole number of tokens`, source);
+        }
+        budgets[pattern] = tokens;
+    }
+    return budgets;
+}
+/**
+ * Validates the `baseline` block.
+ *
+ * **A baseline with no threshold is an error, not a default.** Either default is
+ * wrong in a way that is silent: zero tolerance turns every honest addition into
+ * a failed build and gets the whole block deleted within a week, and a generous
+ * default is a gate that passes things nobody agreed to let through. The number
+ * is a policy decision, so the policy has to be written down.
+ *
+ * `path` defaults, because there is one sensible answer and repeating it in every
+ * config is noise.
+ */
+function parseBaselineConfig(raw, source) {
+    if (!isPlainObject(raw))
+        throw new ConfigError('"baseline" must be an object', source);
+    rejectUnknownKeys(raw, CONFIG_BASELINE_KEYS, source, 'baseline.');
+    const baseline = { path: BASELINE_FILENAME };
+    if (raw.path !== undefined) {
+        if (typeof raw.path !== 'string' || raw.path.trim() === '') {
+            throw new ConfigError('"baseline.path" must be a path to a baseline file', source);
+        }
+        if (IS_ABSOLUTE.test(raw.path) || raw.path.includes('..')) {
+            throw new ConfigError(`"baseline.path" must be a relative path inside the project (got "${raw.path}")`, source);
+        }
+        baseline.path = raw.path;
+    }
+    if (raw.maxGrowthTokens !== undefined) {
+        const tokens = requireNonNegativeNumber(raw.maxGrowthTokens, 'baseline.maxGrowthTokens', source);
+        if (!Number.isInteger(tokens)) {
+            throw new ConfigError('"baseline.maxGrowthTokens" must be a whole number of tokens', source);
+        }
+        baseline.maxGrowthTokens = tokens;
+    }
+    if (raw.maxGrowthPct !== undefined) {
+        baseline.maxGrowthPct = requireNonNegativeNumber(raw.maxGrowthPct, 'baseline.maxGrowthPct', source);
+    }
+    if (baseline.maxGrowthTokens === undefined && baseline.maxGrowthPct === undefined) {
+        throw new ConfigError('"baseline" needs at least one of "maxGrowthTokens" or "maxGrowthPct" — ' +
+            'a baseline with no threshold cannot fail, and a gate that cannot fail is not a gate', source);
+    }
+    return baseline;
+}
+/**
+ * Checks a config's `usage.model` against a resolved catalogue.
+ *
+ * Separate from `parseConfig` because it needs the catalogue, and the catalogue
+ * may be defined by the very document being parsed — `pricing` is a config key.
+ * `loadConfig` calls this once the overlay is in hand, so a typo'd model is still
+ * a loud error, just one raised at the point where "unknown model" can be
+ * answered truthfully.
+ */
+export function validateConfigModel(config, catalogue, source) {
+    const model = config.usage?.model;
+    if (model === undefined || catalogue.byId.has(model))
+        return;
+    const ids = catalogue.models.map((m) => m.id);
+    const nearest = nearestName(model, ids);
+    throw new ConfigError(nearest
+        ? `"usage.model" names no such model: "${model}" — did you mean "${nearest}"?`
+        : `"usage.model" names no such model: "${model}". Available: ${ids.join(', ')}`, source);
+}
+/**
+ * Validates a config document.
+ *
+ * `source` names the file in every error, because a config error found while
+ * running `trazum check` in a monorepo is useless without knowing which of
+ * several config files it came from.
+ */
+export function parseConfig(raw, source = CONFIG_FILENAME) {
+    let document;
+    try {
+        document = JSON.parse(raw);
+    }
+    catch (error) {
+        const detail = error instanceof Error ? error.message : String(error);
+        throw new ConfigError(`not valid JSON — ${detail}`, source);
+    }
+    if (!isPlainObject(document)) {
+        throw new ConfigError('the top level must be an object', source);
+    }
+    rejectUnknownKeys(document, TOP_LEVEL_KEYS, source, '');
+    const config = {};
+    if (document.level !== undefined) {
+        if (document.level !== 'safe' && document.level !== 'aggressive') {
+            throw new ConfigError('"level" must be "safe" or "aggressive"', source);
+        }
+        config.level = document.level;
+    }
+    if (document.locale !== undefined) {
+        if (typeof document.locale !== 'string' || !isLocale(document.locale)) {
+            throw new ConfigError(`"locale" is not a locale Trazum ships: ${String(document.locale)}`, source);
+        }
+        config.locale = document.locale;
+    }
+    if (document.disable !== undefined) {
+        if (!Array.isArray(document.disable)) {
+            throw new ConfigError('"disable" must be an array of rule ids', source);
+        }
+        const ids = RULES.map((rule) => rule.id);
+        config.disable = document.disable.map((value) => {
+            if (typeof value !== 'string' || !ids.includes(value)) {
+                const nearest = typeof value === 'string' ? nearestName(value, ids) : null;
+                throw new ConfigError(nearest
+                    ? `"disable" names no such rule: "${String(value)}" — did you mean "${nearest}"?`
+                    : `"disable" names no such rule: "${String(value)}". Run "trazum rules" for the list.`, source);
+            }
+            return value;
+        });
+    }
+    if (document.usage !== undefined)
+        config.usage = parseUsage(document.usage, source);
+    if (document.budgets !== undefined)
+        config.budgets = parseBudgets(document.budgets, source);
+    if (document.baseline !== undefined) {
+        config.baseline = parseBaselineConfig(document.baseline, source);
+    }
+    if (document.maxGrowth !== undefined) {
+        config.maxGrowth = requireNonNegativeNumber(document.maxGrowth, 'maxGrowth', source);
+    }
+    if (document.pricing !== undefined) {
+        if (typeof document.pricing !== 'string' || document.pricing.trim() === '') {
+            throw new ConfigError('"pricing" must be a path to a pricing overlay file', source);
+        }
+        if (IS_ABSOLUTE.test(document.pricing) || document.pricing.includes('..')) {
+            throw new ConfigError(`"pricing" must be a relative path inside the project (got "${document.pricing}")`, source);
+        }
+        config.pricing = document.pricing;
+    }
+    if (document.extensions !== undefined) {
+        if (!Array.isArray(document.extensions) || document.extensions.length === 0) {
+            throw new ConfigError('"extensions" must be a non-empty array of strings', source);
+        }
+        config.extensions = document.extensions.map((value) => {
+            if (typeof value !== 'string' || value.length < 2 || !value.startsWith('.')) {
+                throw new ConfigError(`"extensions" entries look like ".txt"; got ${JSON.stringify(value)}`, source);
+            }
+            return value.toLowerCase();
+        });
+    }
+    return config;
+}
+/**
+ * The budget that applies to a path, or null when no pattern matches.
+ *
+ * Returning the pattern alongside the number is the point: a file failing
+ * against a budget the reader cannot locate in their config is a bug report.
+ */
+export function budgetFor(path, budgets) {
+    if (!budgets)
+        return null;
+    const pattern = mostSpecificMatch(Object.keys(budgets), path);
+    return pattern === null ? null : { pattern, maxTokens: budgets[pattern] };
+}
+//# sourceMappingURL=config-schema.js.map

package/dist/config-schema.js.map

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

package/dist/config.d.ts

@@ -0,0 +1,47 @@
+import type { TrazumConfig } from './config-schema.js';
+import type { PricingCatalogue } from './pricing.js';
+/**
+ * Finding and reading `trazum.config.json`.
+ *
+ * Split from the schema in `config-schema.ts` because this is the only half
+ * that touches the filesystem, and the split is load-bearing: `apps/web`
+ * bundles `@trazum/core` for the browser, where a single `node:fs` import
+ * anywhere in the graph fails the build. Reachable only through
+ * `@trazum/core/node`, which the CLI imports and the web app does not.
+ */
+export interface LoadedConfig {
+    config: TrazumConfig;
+    /** Absolute path the config came from, or null when none was found. */
+    path: string | null;
+    /**
+     * Prices to work from: the bundled catalogue, with the config's `pricing`
+     * overlay applied if it named one. Always present, so a caller never has to
+     * decide which of two sources to use.
+     */
+    pricing: PricingCatalogue;
+    /** Absolute path the overlay came from, or null when there was none. */
+    pricingPath: string | null;
+}
+export interface LoadConfigOptions {
+    /** Directory to start the upward search from. Defaults to the process cwd. */
+    from?: string;
+    /**
+     * An explicit path. Given one, no search happens and a missing file is an
+     * error: somebody who names a config file is not asking for defaults.
+     */
+    explicit?: string;
+}
+/**
+ * Finds and reads the nearest config file.
+ *
+ * The search walks **upward from the working directory**, which is what makes
+ * `cd packages/thing && trazum check prompt.txt` pick up the repository's
+ * config. It stops at the first hit, at a directory containing `.git`, or after
+ * `MAX_CONFIG_SEARCH_DEPTH` levels — a bound rather than an unlimited climb to
+ * the filesystem root.
+ *
+ * Finding nothing is not an error: the tool is useful with no config at all,
+ * and returning `{config: {}, path: null}` lets the caller say so.
+ */
+export declare function loadConfig(options?: LoadConfigOptions): Promise<LoadedConfig>;
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAEvD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAGrD;;;;;;;;GAQG;AAEH,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,YAAY,CAAC;IACrB,uEAAuE;IACvE,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB;;;;OAIG;IACH,OAAO,EAAE,gBAAgB,CAAC;IAC1B,wEAAwE;IACxE,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;CAC5B;AA4DD,MAAM,WAAW,iBAAiB;IAChC,8EAA8E;IAC9E,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;;;;;;;;;;GAWG;AACH,wBAAsB,UAAU,CAAC,OAAO,GAAE,iBAAsB,GAAG,OAAO,CAAC,YAAY,CAAC,CA2BvF"}

package/dist/config.js

@@ -0,0 +1,112 @@
+import { open, stat } from 'node:fs/promises';
+import { dirname, join, resolve, sep } from 'node:path';
+import { CONFIG_FILENAME, ConfigError, MAX_CONFIG_BYTES, MAX_CONFIG_SEARCH_DEPTH, parseConfig, validateConfigModel, } from './config-schema.js';
+import { BUNDLED_CATALOGUE } from './pricing.js';
+import { MAX_PRICING_BYTES, PricingOverlayError, applyPricingOverlay, parsePricingOverlay } from './pricing-overlay.js';
+/**
+ * Resolves a config's `pricing` overlay, if it names one.
+ *
+ * The path is relative to **the config file**, not the working directory, so a
+ * config found by walking upward still finds its own overlay. Reusing
+ * `readIfPresent` means the overlay gets the same one-handle read and the same
+ * size limit as the config itself.
+ */
+async function resolvePricing(config, configPath) {
+    if (!config.pricing)
+        return { pricing: BUNDLED_CATALOGUE, pricingPath: null };
+    const path = resolve(dirname(configPath), config.pricing);
+    const raw = await readIfPresent(path, MAX_PRICING_BYTES);
+    if (raw === null) {
+        // Named and missing is an error, for the same reason `--config` is: somebody
+        // who points at a price list is not asking for the bundled one.
+        throw new PricingOverlayError('no such pricing overlay', path);
+    }
+    return {
+        pricing: applyPricingOverlay(BUNDLED_CATALOGUE, parsePricingOverlay(raw, path), path),
+        pricingPath: path,
+    };
+}
+/**
+ * Reads a config file if it is there, or returns null.
+ *
+ * **The handle is opened once and everything is asked of the handle**, not of
+ * the path again. Checking the size with `stat(path)` and then reading with
+ * `readFile(path)` resolves the name twice, so what gets read is not
+ * necessarily what got measured — a symlink swapped in between the two calls
+ * defeats the size limit entirely, and on a CI runner checking out a pull
+ * request that is not a hypothetical attacker. One `open`, then `fh.stat()` and
+ * `fh.readFile()`, refer to the same file object throughout.
+ */
+async function readIfPresent(path, limit = MAX_CONFIG_BYTES) {
+    let handle;
+    try {
+        handle = await open(path, 'r');
+    }
+    catch {
+        return null;
+    }
+    try {
+        const info = await handle.stat();
+        if (!info.isFile())
+            return null;
+        if (info.size > limit) {
+            throw new ConfigError(`is ${info.size} bytes, over the ${limit}-byte limit`, path);
+        }
+        return await handle.readFile('utf8');
+    }
+    finally {
+        await handle.close();
+    }
+}
+/**
+ * Finds and reads the nearest config file.
+ *
+ * The search walks **upward from the working directory**, which is what makes
+ * `cd packages/thing && trazum check prompt.txt` pick up the repository's
+ * config. It stops at the first hit, at a directory containing `.git`, or after
+ * `MAX_CONFIG_SEARCH_DEPTH` levels — a bound rather than an unlimited climb to
+ * the filesystem root.
+ *
+ * Finding nothing is not an error: the tool is useful with no config at all,
+ * and returning `{config: {}, path: null}` lets the caller say so.
+ */
+export async function loadConfig(options = {}) {
+    if (options.explicit !== undefined) {
+        const path = resolve(options.explicit);
+        const raw = await readIfPresent(path);
+        if (raw === null)
+            throw new ConfigError('no such config file', path);
+        return finish(parseConfig(raw, path), path);
+    }
+    let directory = resolve(options.from ?? process.cwd());
+    for (let depth = 0; depth < MAX_CONFIG_SEARCH_DEPTH; depth++) {
+        const candidate = join(directory, CONFIG_FILENAME);
+        const raw = await readIfPresent(candidate);
+        if (raw !== null)
+            return finish(parseConfig(raw, candidate), candidate);
+        // A repository root is a deliberate stopping point: reaching past it would
+        // read a config belonging to whatever happens to be above the checkout,
+        // which on a CI runner is not the project's business.
+        const gitDirectory = await stat(join(directory, '.git')).catch(() => null);
+        if (gitDirectory)
+            break;
+        const parent = dirname(directory);
+        if (parent === directory || parent === sep)
+            break;
+        directory = parent;
+    }
+    return { config: {}, path: null, pricing: BUNDLED_CATALOGUE, pricingPath: null };
+}
+/**
+ * Resolves the overlay and checks the model, in that order.
+ *
+ * The order is the point: `usage.model` may name a model the overlay introduces,
+ * so validating it before the overlay is read would reject a config that is
+ * correct.
+ */
+async function finish(config, path) {
+    const { pricing, pricingPath } = await resolvePricing(config, path);
+    validateConfigModel(config, pricing, path);
+    return { config, path, pricing, pricingPath };
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

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

package/dist/detect.d.ts

@@ -0,0 +1,70 @@
+import type { ModelPricing } from './types.js';
+/**
+ * Where a prompt is actually going.
+ *
+ * Trazum priced one vendor, so defaulting to Claude cost nothing. Pricing seven
+ * made that default a **wrong number**: `trazum check src/prompts.ts` billed a
+ * file that calls OpenAI against Claude Opus 5 and said so with a straight face.
+ * The fix is not a better default — it is reading what the code already says.
+ *
+ * Everything here is **evidence-first**. A detection that cannot name what it
+ * saw is a guess wearing a result's clothes, and this feeds a command used as a
+ * CI gate. Every answer carries the line it came from, so a wrong one is
+ * arguable rather than mysterious.
+ *
+ * **It declines when the file points two ways.** A module importing both
+ * `openai` and `@anthropic-ai/sdk` is a module Trazum cannot price without
+ * picking a side, and picking silently is how somebody budgets against the wrong
+ * provider for a month. The conflict is reported and the caller falls back to
+ * whatever they configured.
+ *
+ * Detection sits **between config and defaults** in the usual layering: a flag
+ * beats config, config beats detection, detection beats the built-in default.
+ * Reading the code is better than assuming, and worse than being told.
+ */
+export type EvidenceKind = 
+/** `model: 'gpt-5'` — names the model outright, so nothing beats it. */
+'model-literal'
+/** `from 'openai'` — names the provider but not which model. */
+ | 'sdk-import'
+/** `https://api.deepseek.com` — a base URL pinned in the source. */
+ | 'base-url'
+/** `// trazum:prompt name model=gpt-5` — the author said so directly. */
+ | 'marker';
+export interface Evidence {
+    kind: EvidenceKind;
+    /** The text that produced it, so the reader can go and look. */
+    detail: string;
+    /** 1-based line, when it came from a specific place in the file. */
+    line?: number;
+    provider?: string;
+    model?: string;
+}
+export interface Detection {
+    /** The provider, or null when nothing was found or the file disagreed. */
+    provider: string | null;
+    /** The exact model, when something named one. */
+    model: string | null;
+    /** What was found, strongest first. Empty when nothing was. */
+    evidence: Evidence[];
+    /**
+     * Evidence pointing somewhere other than the answer.
+     *
+     * Non-empty means the file names more than one provider, and `provider` is
+     * null: two answers is not a weaker version of one answer.
+     */
+    conflicts: Evidence[];
+}
+export interface DetectOptions {
+    /** The catalogue to recognise model names from. */
+    models?: ModelPricing[];
+}
+/**
+ * Works out which provider a source file talks to, and says why.
+ *
+ * Returns `provider: null` both when nothing was found and when the file named
+ * more than one — the caller cannot act on either, and `conflicts` distinguishes
+ * them for the reader.
+ */
+export declare function detectFromSource(source: string, options?: DetectOptions): Detection;
+//# 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":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE/C;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,MAAM,MAAM,YAAY;AACtB,wEAAwE;AACtE,eAAe;AACjB,gEAAgE;GAC9D,YAAY;AACd,oEAAoE;GAClE,UAAU;AACZ,yEAAyE;GACvE,QAAQ,CAAC;AAEb,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,YAAY,CAAC;IACnB,gEAAgE;IAChE,MAAM,EAAE,MAAM,CAAC;IACf,oEAAoE;IACpE,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,SAAS;IACxB,0EAA0E;IAC1E,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,iDAAiD;IACjD,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,+DAA+D;IAC/D,QAAQ,EAAE,QAAQ,EAAE,CAAC;IACrB;;;;;OAKG;IACH,SAAS,EAAE,QAAQ,EAAE,CAAC;CACvB;AA8JD,MAAM,WAAW,aAAa;IAC5B,mDAAmD;IACnD,MAAM,CAAC,EAAE,YAAY,EAAE,CAAC;CACzB;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,GAAE,aAAkB,GAAG,SAAS,CAiFvF"}