modelrig 0.0.1 → 0.1.0

package/dist/index.js

@@ -0,0 +1,448 @@
+"use strict";
+/**
+ * modelrig public surface — plan step 7.
+ * Usage sketch (normative):
+ *   const rig = createRig(loadConfigFromEnv());
+ *   const result = await rig.run("research.growth_scenarios", {
+ *     input: { ticker, financials, priorSteps },
+ *     tags: { run_id, step: "growth_scenarios", ticker },
+ *     budget: { envelope: run_id },
+ *   });
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.readObjectLiteral = exports.findCallSitesInText = exports.scanRepoForCallSites = exports.capabilitiesFor = exports.routeNameFor = exports.buildMigrationMarkdown = exports.runInit = exports.loadRoutes = exports.RouteConfigError = exports.renderFailureForTerminal = exports.teach = exports.FAILURE_TEACHING = exports.isRigFailure = exports.RigFailureError = exports.extractCitations = exports.createTavilySearchProvider = exports.wilson95 = exports.aggregateVariantMetrics = exports.OUTPUT_MAX_BYTES = exports.retentionExpiry = exports.truncateOutput = exports.selectArmsToKeep = exports.buildBakeoffSamples = exports.createBakeoffSamplesClient = exports.computeProposal = exports.mirrorBakeoff = exports.runBakeoff = exports.replayVariant = exports.openTelemetryStore = exports.openCaptureStore = exports.KEY_SHAPED_PREFIXES = exports.containsKeyShapedString = exports.scrubSecrets = exports.hasScope = exports.parseScopes = exports.redactApiKey = exports.looksLikeApiKey = exports.hashApiKeySecret = exports.API_KEY_SECRET_BYTES = exports.API_KEY_SCOPES = exports.API_KEY_PREFIX = exports.createDirectSink = exports.createApiSink = exports.createTelemetryExporter = exports.DEFAULT_INGEST_URL = exports.INGEST_PROTOCOL_VERSION = exports.INGEST_PATH = exports.foreignOrgFeedback = exports.stampBatch = exports.loadConfigFromEnv = void 0;
+exports.runWatchCycle = exports.assertTransition = exports.createProposalsClient = exports.PROPOSAL_TTL_DAYS = exports.triggerHash = exports.evaluateEvents = exports.RUNG1_MIN_FEEDBACK = exports.computeCoverage = exports.buildFeedbackRow = exports.ALL_CAPABILITY_FLAGS = exports.computeParity = exports.factsUnderCredential = exports.factsFor = exports.PROBE_FRESHNESS_SLO_DAYS = exports.stalenessSentence = exports.probeFreshness = exports.callNotesFor = exports.PREDICATE_GLOSS = exports.ALL_CAPABILITY_PREDICATES = exports.explainEmptySelection = exports.hasCapability = exports.selectModels = exports.parseCapabilityQuery = exports.capabilityFactsFromEntry = exports.loadRegistryFacts = exports.fingerprintSchema = exports.loadManifest = exports.estimateCostUsd = exports.getPricing = exports.resolveCandidates = exports.OPENAI_COMPAT_HOSTS = exports.shapeFireworksModelId = exports.classifyCompatFailure = exports.buildOpenAICompatParams = exports.createOpenAICompatAdapter = exports.createGrokAdapter = exports.createAnthropicAdapter = exports.createDeepSeekAdapter = exports.createOpenAIAdapter = exports.createGeminiAdapter = exports.PROVIDER_KEY_ENV = exports.serveabilityWarnings = exports.checkServeability = exports.writeRouteDraft = exports.buildRouteDraft = exports.splitModelKey = exports.seedCandidates = exports.loadRegistryRows = exports.signatureFor = exports.PROVIDER_SIGNATURES = void 0;
+exports.computeOdometer = exports.createSwapsClient = exports.executeSwap = exports.buildSwapChange = exports.runTelemetryQuery = exports.QueryGrammarError = exports.compileQuery = exports.writePriorsCells = exports.aggregatePairwiseFromTelemetry = exports.aggregatePriors = exports.DEFAULT_WATCH_MONTHLY_USD = exports.watchEnvelopeKey = exports.reserveWatchBudget = exports.WATCH_STATE_KEY = exports.createFileWatchStateStore = exports.createControlPlaneWatchStateStore = exports.createWatchStateStore = exports.saveWatchState = exports.loadWatchState = exports.computeWatchEvents = exports.buildPriceUniverse = void 0;
+exports.createRig = createRig;
+const anthropic_1 = require("./adapters/anthropic");
+const deepseek_1 = require("./adapters/deepseek");
+const gemini_1 = require("./adapters/gemini");
+const grok_1 = require("./adapters/grok");
+const openai_1 = require("./adapters/openai");
+const openai_compat_1 = require("./adapters/openai-compat");
+const loader_1 = require("./routes/loader");
+const serveability_1 = require("./routes/serveability");
+const manifest_1 = require("./routes/manifest");
+const run_1 = require("./run/run");
+const node_path_1 = require("node:path");
+const node_os_1 = require("node:os");
+const grounding_1 = require("./run/grounding");
+const capture_1 = require("./telemetry/capture");
+const store_1 = require("./telemetry/store");
+const exporter_1 = require("./telemetry/exporter");
+const sinks_1 = require("./telemetry/sinks");
+const constants_1 = require("./tenancy/constants");
+const feedback_1 = require("./feedback/feedback");
+const facts_1 = require("./registry/facts");
+const engine_1 = require("./bakeoff/engine");
+const replay_1 = require("./bakeoff/replay");
+const samples_1 = require("./bakeoff/samples");
+const provider_1 = require("./types/provider");
+/** Per-variant replay spend ceiling when the caller doesn't set one. */
+const DEFAULT_REPLAY_ENVELOPE_USD = 10;
+function createRig(config) {
+    const routes = (0, loader_1.loadRoutes)(config.routesDir);
+    // rig.yaml lives at the rig dir root, one level above routes/
+    // (modelrig/rig.yaml next to modelrig/routes/ — cost-dimensions-design §2a).
+    const manifest = (0, manifest_1.loadManifest)((0, node_path_1.dirname)(config.routesDir));
+    // Registry facts load BEFORE adapters: the A1 compat hosts take their
+    // capability profile from the registry, never from the dialect.
+    const registryFacts = (0, facts_1.loadRegistryFacts)(config.registryPath);
+    const COMPAT_STATIC = new Set(["json_mode"]);
+    const adapters = new Map();
+    if (config.keys.gemini)
+        adapters.set("gemini", (0, gemini_1.createGeminiAdapter)({ apiKey: config.keys.gemini }));
+    if (config.keys.openai)
+        adapters.set("openai", (0, openai_1.createOpenAIAdapter)({ apiKey: config.keys.openai }));
+    if (config.keys.deepseek) {
+        adapters.set("deepseek", (0, deepseek_1.createDeepSeekAdapter)({ apiKey: config.keys.deepseek }));
+    }
+    if (config.keys.anthropic) {
+        adapters.set("anthropic", (0, anthropic_1.createAnthropicAdapter)({ apiKey: config.keys.anthropic }));
+    }
+    if (config.keys.grok)
+        adapters.set("grok", (0, grok_1.createGrokAdapter)({ apiKey: config.keys.grok }));
+    // A1 aggregator hosts behind the generic openai-compatible adapter.
+    for (const hostId of ["deepinfra", "fireworks"]) {
+        const apiKey = config.keys[hostId];
+        if (!apiKey)
+            continue;
+        const host = openai_compat_1.OPENAI_COMPAT_HOSTS[hostId];
+        adapters.set(hostId, (0, openai_compat_1.createOpenAICompatAdapter)({
+            providerId: hostId,
+            baseUrl: host.baseUrl,
+            apiKey,
+            ...(host.shapeModelId !== undefined ? { shapeModelId: host.shapeModelId } : {}),
+            capabilityProfile: (model) => registryFacts.flagsFor(hostId, model, COMPAT_STATIC) ?? COMPAT_STATIC,
+        }));
+    }
+    // Load-time serveability (Phase 4 resilience): a keyless declared
+    // candidate is INERT, not fatal — warn and keep serving on keyed
+    // candidates; only a route with ZERO serveable candidates is a hard error.
+    // The run loop skips inert candidates at dispatch; the candidate-set upper
+    // bound is untouched. (Was: throw on the first keyless candidate, which
+    // downed the standalone server on any keyless challenger arm.)
+    const serveability = (0, serveability_1.serveabilityWarnings)(routes.list(), (p) => adapters.has(p));
+    for (const warning of serveability) {
+        console.warn(`[modelrig] ${warning.message} (${warning.fixHint})`);
+    }
+    // Registry-wired capability facts (Phase 3 WS6): the Phase 1 stub — grant
+    // whatever the adapter claims — is gone. Precedence per flag:
+    // capabilityOverrides > probed > declared (adapter-static is the declared
+    // baseline for unprobed call-shaping dimensions); models absent from the
+    // registry fall back to the adapter-static map alone.
+    const capabilities = (provider, model) => {
+        const override = config.capabilityOverrides?.[provider];
+        if (override !== undefined)
+            return new Set(override);
+        const adapter = adapters.get(provider);
+        if (adapter === undefined)
+            return new Set();
+        const staticFlags = new Set(provider_1.ALL_CAPABILITY_FLAGS.filter((flag) => adapter.supports(flag, model)));
+        return registryFacts.flagsFor(provider, model, staticFlags) ?? staticFlags;
+    };
+    const telemetry = (0, store_1.openTelemetryStore)(config.telemetryDbPath);
+    // Local-only capture store (Phase 3 WS4): opened only when a bundle opts
+    // in; a SEPARATE handle over the same file — the exporter cannot reach it.
+    let captures = null;
+    if (routes.list().some((b) => b.capture)) {
+        captures = (0, capture_1.openCaptureStore)(config.telemetryDbPath);
+    }
+    // Grounding-inject search provider (Phase 3 WS3).
+    const search = config.search !== undefined
+        ? (0, grounding_1.createTavilySearchProvider)({
+            apiKey: config.search.tavilyApiKey,
+            ...(config.search.costPerSearchUsd !== undefined
+                ? { costPerSearchUsd: config.search.costPerSearchUsd }
+                : {}),
+            ...(config.search.searchDepth !== undefined
+                ? { searchDepth: config.search.searchDepth }
+                : {}),
+        })
+        : null;
+    // Cloud sink (optional, fire-and-forget): the run loop never blocks on or
+    // fails because of it — the exporter swallows all sink errors.
+    let exporter = null;
+    if (config.export !== undefined) {
+        const exportConfig = config.export;
+        const sourceId = exportConfig.sourceId ?? (0, node_os_1.hostname)();
+        const sink = exportConfig.mode === "api"
+            ? (0, sinks_1.createApiSink)({
+                ingestUrl: exportConfig.ingestUrl,
+                apiKey: exportConfig.apiKey,
+                // A batch the server partly refused comes back 200. Without this,
+                // a customer whose rows are being dropped would find out by
+                // noticing a gap in a chart weeks later.
+                onOutcome: (outcome) => {
+                    const dropped = Object.values(outcome.dropped).reduce((a, b) => a + b, 0);
+                    if (dropped === 0)
+                        return;
+                    const reasons = Object.entries(outcome.reasons)
+                        .map(([reason, count]) => `${reason}×${count}`)
+                        .join(", ");
+                    console.warn(`[modelrig exporter] ingest dropped ${dropped} row(s): ${reasons}`);
+                },
+            })
+            : (0, sinks_1.createDirectSink)({
+                supabaseUrl: exportConfig.supabaseUrl,
+                serviceRoleKey: exportConfig.serviceRoleKey,
+                tenancy: {
+                    org_id: exportConfig.orgId ?? constants_1.HOUSE_ORG_ID,
+                    project_id: exportConfig.projectId ?? null,
+                    source_id: sourceId,
+                },
+            });
+        exporter = (0, exporter_1.createTelemetryExporter)(telemetry, {
+            sink,
+            sourceId,
+            ...(exportConfig.batchSize !== undefined ? { batchSize: exportConfig.batchSize } : {}),
+            ...(exportConfig.intervalMs !== undefined ? { intervalMs: exportConfig.intervalMs } : {}),
+            routes: routes.list().map((b) => ({
+                route: b.route,
+                version: b.version,
+                candidates: b.candidates.map((c) => ({ provider: c.provider, model: c.model })),
+                capture: b.capture,
+            })),
+            manifest,
+            serveability,
+        });
+        exporter.start();
+    }
+    const deps = {
+        routes,
+        adapters,
+        telemetry,
+        capabilities,
+        manifest,
+        captures,
+        search,
+        ...(config.envelopeBudgetUsd !== undefined
+            ? { envelopeBudgetUsd: config.envelopeBudgetUsd }
+            : {}),
+        ...(config.unpricedRateUsdPerMTok !== undefined
+            ? { unpricedRateUsdPerMTok: config.unpricedRateUsdPerMTok }
+            : {}),
+    };
+    // Replay reads captures even when no route currently opts in to writing
+    // them — open the read handle lazily.
+    function captureStoreForReplay() {
+        if (captures === null) {
+            captures = (0, capture_1.openCaptureStore)(config.telemetryDbPath);
+        }
+        return captures;
+    }
+    // Bake-off review-sample sink (addendum A3): persists retained outputs to
+    // the SEPARATE bakeoff_samples store (service role; deny-anon RLS). Only
+    // exists when the control plane is configured — captures never touch it.
+    //
+    // DIRECT MODE ONLY, and that is a real limitation, not an oversight:
+    // `bakeoff_samples` has no ingest route (telemetry-ingestion-boundary.md §2
+    // covers telemetry, not review samples), so an api-mode rig keeps its
+    // retained outputs local. Flagged for the architect in the WS2 report
+    // rather than papered over — a silent no-op here would look like data loss.
+    const directExport = config.export?.mode === "direct" ? config.export : undefined;
+    const samplesSink = directExport !== undefined
+        ? async ({ bakeoffId, route, arms }) => {
+            const rows = (0, samples_1.buildBakeoffSamples)(bakeoffId, route, arms, (0, samples_1.retentionExpiry)(Date.now()));
+            await (0, samples_1.createBakeoffSamplesClient)({
+                supabaseUrl: directExport.supabaseUrl,
+                serviceRoleKey: directExport.serviceRoleKey,
+            }).insert(rows);
+        }
+        : undefined;
+    return {
+        serveability,
+        run(route, opts) {
+            return (0, run_1.run)(deps, route, opts);
+        },
+        feedback(target, opts) {
+            const row = (0, feedback_1.buildFeedbackRow)(target, opts);
+            telemetry.recordFeedback(row);
+            return row;
+        },
+        replay(route, opts) {
+            return (0, replay_1.replayVariant)(deps, captureStoreForReplay(), {
+                route,
+                variant: opts.variant,
+                lastN: opts.lastN,
+                envelopeUsd: opts.envelopeUsd ?? DEFAULT_REPLAY_ENVELOPE_USD,
+            });
+        },
+        bakeoff(route, opts) {
+            return (0, engine_1.runBakeoff)(deps, captureStoreForReplay(), {
+                route,
+                variants: opts.variants,
+                replayLastN: opts.replayLastN,
+                envelopeUsdPerVariant: opts.envelopeUsdPerVariant ?? DEFAULT_REPLAY_ENVELOPE_USD,
+                ...(opts.keepOutputs !== undefined ? { keepOutputs: opts.keepOutputs } : {}),
+            }, samplesSink);
+        },
+        close() {
+            captures?.close();
+            if (exporter !== null) {
+                // Final best-effort flush; sink errors are swallowed by the exporter.
+                void exporter.stop().finally(() => telemetry.close());
+                return;
+            }
+            telemetry.close();
+        },
+    };
+}
+var config_1 = require("./config");
+Object.defineProperty(exports, "loadConfigFromEnv", { enumerable: true, get: function () { return config_1.loadConfigFromEnv; } });
+// The telemetry wire contract (Phase 6 WS2). Exported because modelrig-server
+// COMPILES AGAINST IT: one definition of a batch and one mapper from batch to
+// database rows, shared by the SDK's two sinks and the ingest endpoint. A
+// second copy on the server side is exactly the drift this prevents.
+var ingest_protocol_1 = require("./telemetry/ingest-protocol");
+Object.defineProperty(exports, "stampBatch", { enumerable: true, get: function () { return ingest_protocol_1.stampBatch; } });
+Object.defineProperty(exports, "foreignOrgFeedback", { enumerable: true, get: function () { return ingest_protocol_1.foreignOrgFeedback; } });
+Object.defineProperty(exports, "INGEST_PATH", { enumerable: true, get: function () { return ingest_protocol_1.INGEST_PATH; } });
+Object.defineProperty(exports, "INGEST_PROTOCOL_VERSION", { enumerable: true, get: function () { return ingest_protocol_1.INGEST_PROTOCOL_VERSION; } });
+Object.defineProperty(exports, "DEFAULT_INGEST_URL", { enumerable: true, get: function () { return ingest_protocol_1.DEFAULT_INGEST_URL; } });
+var exporter_2 = require("./telemetry/exporter");
+Object.defineProperty(exports, "createTelemetryExporter", { enumerable: true, get: function () { return exporter_2.createTelemetryExporter; } });
+var sinks_2 = require("./telemetry/sinks");
+Object.defineProperty(exports, "createApiSink", { enumerable: true, get: function () { return sinks_2.createApiSink; } });
+Object.defineProperty(exports, "createDirectSink", { enumerable: true, get: function () { return sinks_2.createDirectSink; } });
+// The rig_sk_ key FORMAT (not minting — that is the control plane's). Shared
+// so the SDK, the server and the oracle cannot disagree about what a key is.
+var api_key_format_1 = require("./tenancy/api-key-format");
+Object.defineProperty(exports, "API_KEY_PREFIX", { enumerable: true, get: function () { return api_key_format_1.API_KEY_PREFIX; } });
+Object.defineProperty(exports, "API_KEY_SCOPES", { enumerable: true, get: function () { return api_key_format_1.API_KEY_SCOPES; } });
+Object.defineProperty(exports, "API_KEY_SECRET_BYTES", { enumerable: true, get: function () { return api_key_format_1.API_KEY_SECRET_BYTES; } });
+Object.defineProperty(exports, "hashApiKeySecret", { enumerable: true, get: function () { return api_key_format_1.hashApiKeySecret; } });
+Object.defineProperty(exports, "looksLikeApiKey", { enumerable: true, get: function () { return api_key_format_1.looksLikeApiKey; } });
+Object.defineProperty(exports, "redactApiKey", { enumerable: true, get: function () { return api_key_format_1.redactApiKey; } });
+Object.defineProperty(exports, "parseScopes", { enumerable: true, get: function () { return api_key_format_1.parseScopes; } });
+Object.defineProperty(exports, "hasScope", { enumerable: true, get: function () { return api_key_format_1.hasScope; } });
+// C2's leak gate — the one secret-scrubber every failure/telemetry/export/log
+// boundary shares. Widened in WS3 to the BYOK provider families.
+var scrub_1 = require("./tenancy/scrub");
+Object.defineProperty(exports, "scrubSecrets", { enumerable: true, get: function () { return scrub_1.scrubSecrets; } });
+Object.defineProperty(exports, "containsKeyShapedString", { enumerable: true, get: function () { return scrub_1.containsKeyShapedString; } });
+Object.defineProperty(exports, "KEY_SHAPED_PREFIXES", { enumerable: true, get: function () { return scrub_1.KEY_SHAPED_PREFIXES; } });
+var capture_2 = require("./telemetry/capture");
+Object.defineProperty(exports, "openCaptureStore", { enumerable: true, get: function () { return capture_2.openCaptureStore; } });
+var store_2 = require("./telemetry/store");
+Object.defineProperty(exports, "openTelemetryStore", { enumerable: true, get: function () { return store_2.openTelemetryStore; } });
+var replay_2 = require("./bakeoff/replay");
+Object.defineProperty(exports, "replayVariant", { enumerable: true, get: function () { return replay_2.replayVariant; } });
+var engine_2 = require("./bakeoff/engine");
+Object.defineProperty(exports, "runBakeoff", { enumerable: true, get: function () { return engine_2.runBakeoff; } });
+Object.defineProperty(exports, "mirrorBakeoff", { enumerable: true, get: function () { return engine_2.mirrorBakeoff; } });
+Object.defineProperty(exports, "computeProposal", { enumerable: true, get: function () { return engine_2.computeProposal; } });
+var samples_2 = require("./bakeoff/samples");
+Object.defineProperty(exports, "createBakeoffSamplesClient", { enumerable: true, get: function () { return samples_2.createBakeoffSamplesClient; } });
+Object.defineProperty(exports, "buildBakeoffSamples", { enumerable: true, get: function () { return samples_2.buildBakeoffSamples; } });
+Object.defineProperty(exports, "selectArmsToKeep", { enumerable: true, get: function () { return samples_2.selectArmsToKeep; } });
+Object.defineProperty(exports, "truncateOutput", { enumerable: true, get: function () { return samples_2.truncateOutput; } });
+Object.defineProperty(exports, "retentionExpiry", { enumerable: true, get: function () { return samples_2.retentionExpiry; } });
+Object.defineProperty(exports, "OUTPUT_MAX_BYTES", { enumerable: true, get: function () { return samples_2.OUTPUT_MAX_BYTES; } });
+var stats_1 = require("./bakeoff/stats");
+Object.defineProperty(exports, "aggregateVariantMetrics", { enumerable: true, get: function () { return stats_1.aggregateVariantMetrics; } });
+Object.defineProperty(exports, "wilson95", { enumerable: true, get: function () { return stats_1.wilson95; } });
+var grounding_2 = require("./run/grounding");
+Object.defineProperty(exports, "createTavilySearchProvider", { enumerable: true, get: function () { return grounding_2.createTavilySearchProvider; } });
+Object.defineProperty(exports, "extractCitations", { enumerable: true, get: function () { return grounding_2.extractCitations; } });
+var failures_1 = require("./types/failures");
+Object.defineProperty(exports, "RigFailureError", { enumerable: true, get: function () { return failures_1.RigFailureError; } });
+Object.defineProperty(exports, "isRigFailure", { enumerable: true, get: function () { return failures_1.isRigFailure; } });
+// Errors that teach (Phase 5 WS3) — one table, consumed by CLI + server.
+var failures_teaching_1 = require("./types/failures-teaching");
+Object.defineProperty(exports, "FAILURE_TEACHING", { enumerable: true, get: function () { return failures_teaching_1.FAILURE_TEACHING; } });
+Object.defineProperty(exports, "teach", { enumerable: true, get: function () { return failures_teaching_1.teach; } });
+Object.defineProperty(exports, "renderFailureForTerminal", { enumerable: true, get: function () { return failures_teaching_1.renderFailureForTerminal; } });
+var loader_2 = require("./routes/loader");
+Object.defineProperty(exports, "RouteConfigError", { enumerable: true, get: function () { return loader_2.RouteConfigError; } });
+Object.defineProperty(exports, "loadRoutes", { enumerable: true, get: function () { return loader_2.loadRoutes; } });
+// `modelrig init` (Phase 5 WS2) — repo scan → drafted route bundles.
+var run_2 = require("./init/run");
+Object.defineProperty(exports, "runInit", { enumerable: true, get: function () { return run_2.runInit; } });
+Object.defineProperty(exports, "buildMigrationMarkdown", { enumerable: true, get: function () { return run_2.buildMigrationMarkdown; } });
+Object.defineProperty(exports, "routeNameFor", { enumerable: true, get: function () { return run_2.routeNameFor; } });
+Object.defineProperty(exports, "capabilitiesFor", { enumerable: true, get: function () { return run_2.capabilitiesFor; } });
+var finder_1 = require("./init/finder");
+Object.defineProperty(exports, "scanRepoForCallSites", { enumerable: true, get: function () { return finder_1.scanRepoForCallSites; } });
+Object.defineProperty(exports, "findCallSitesInText", { enumerable: true, get: function () { return finder_1.findCallSitesInText; } });
+Object.defineProperty(exports, "readObjectLiteral", { enumerable: true, get: function () { return finder_1.readObjectLiteral; } });
+var signatures_1 = require("./init/signatures");
+Object.defineProperty(exports, "PROVIDER_SIGNATURES", { enumerable: true, get: function () { return signatures_1.PROVIDER_SIGNATURES; } });
+Object.defineProperty(exports, "signatureFor", { enumerable: true, get: function () { return signatures_1.signatureFor; } });
+var rows_1 = require("./registry/rows");
+Object.defineProperty(exports, "loadRegistryRows", { enumerable: true, get: function () { return rows_1.loadRegistryRows; } });
+var seed_1 = require("./registry/seed");
+Object.defineProperty(exports, "seedCandidates", { enumerable: true, get: function () { return seed_1.seedCandidates; } });
+Object.defineProperty(exports, "splitModelKey", { enumerable: true, get: function () { return seed_1.splitModelKey; } });
+// Route drafting (Phase 5) — shared by `modelrig init` and oracle create_route.
+var draft_1 = require("./routes/draft");
+Object.defineProperty(exports, "buildRouteDraft", { enumerable: true, get: function () { return draft_1.buildRouteDraft; } });
+Object.defineProperty(exports, "writeRouteDraft", { enumerable: true, get: function () { return draft_1.writeRouteDraft; } });
+var serveability_2 = require("./routes/serveability");
+Object.defineProperty(exports, "checkServeability", { enumerable: true, get: function () { return serveability_2.checkServeability; } });
+Object.defineProperty(exports, "serveabilityWarnings", { enumerable: true, get: function () { return serveability_2.serveabilityWarnings; } });
+var config_2 = require("./config");
+Object.defineProperty(exports, "PROVIDER_KEY_ENV", { enumerable: true, get: function () { return config_2.PROVIDER_KEY_ENV; } });
+// Probe-suite surface (Phase 2 plan §4: probes drive adapters DIRECTLY, and
+// mint CandidateRefs through resolveCandidates — the single brand site —
+// against their own single-candidate probe routes).
+var gemini_2 = require("./adapters/gemini");
+Object.defineProperty(exports, "createGeminiAdapter", { enumerable: true, get: function () { return gemini_2.createGeminiAdapter; } });
+var openai_2 = require("./adapters/openai");
+Object.defineProperty(exports, "createOpenAIAdapter", { enumerable: true, get: function () { return openai_2.createOpenAIAdapter; } });
+var deepseek_2 = require("./adapters/deepseek");
+Object.defineProperty(exports, "createDeepSeekAdapter", { enumerable: true, get: function () { return deepseek_2.createDeepSeekAdapter; } });
+var anthropic_2 = require("./adapters/anthropic");
+Object.defineProperty(exports, "createAnthropicAdapter", { enumerable: true, get: function () { return anthropic_2.createAnthropicAdapter; } });
+var grok_2 = require("./adapters/grok");
+Object.defineProperty(exports, "createGrokAdapter", { enumerable: true, get: function () { return grok_2.createGrokAdapter; } });
+var openai_compat_2 = require("./adapters/openai-compat");
+Object.defineProperty(exports, "createOpenAICompatAdapter", { enumerable: true, get: function () { return openai_compat_2.createOpenAICompatAdapter; } });
+Object.defineProperty(exports, "buildOpenAICompatParams", { enumerable: true, get: function () { return openai_compat_2.buildOpenAICompatParams; } });
+Object.defineProperty(exports, "classifyCompatFailure", { enumerable: true, get: function () { return openai_compat_2.classifyCompatFailure; } });
+Object.defineProperty(exports, "shapeFireworksModelId", { enumerable: true, get: function () { return openai_compat_2.shapeFireworksModelId; } });
+Object.defineProperty(exports, "OPENAI_COMPAT_HOSTS", { enumerable: true, get: function () { return openai_compat_2.OPENAI_COMPAT_HOSTS; } });
+var resolve_1 = require("./run/resolve");
+Object.defineProperty(exports, "resolveCandidates", { enumerable: true, get: function () { return resolve_1.resolveCandidates; } });
+var pricing_1 = require("./registry/pricing");
+Object.defineProperty(exports, "getPricing", { enumerable: true, get: function () { return pricing_1.getPricing; } });
+Object.defineProperty(exports, "estimateCostUsd", { enumerable: true, get: function () { return pricing_1.estimateCostUsd; } });
+var manifest_2 = require("./routes/manifest");
+Object.defineProperty(exports, "loadManifest", { enumerable: true, get: function () { return manifest_2.loadManifest; } });
+var fingerprint_1 = require("./registry/fingerprint");
+Object.defineProperty(exports, "fingerprintSchema", { enumerable: true, get: function () { return fingerprint_1.fingerprintSchema; } });
+var facts_2 = require("./registry/facts");
+Object.defineProperty(exports, "loadRegistryFacts", { enumerable: true, get: function () { return facts_2.loadRegistryFacts; } });
+Object.defineProperty(exports, "capabilityFactsFromEntry", { enumerable: true, get: function () { return facts_2.capabilityFactsFromEntry; } });
+// Shared capability-selection grammar (Phase 5 WS1) — the console query box
+// and the MCP oracle answer from THIS module, never their own copy.
+var select_1 = require("./registry/select");
+Object.defineProperty(exports, "parseCapabilityQuery", { enumerable: true, get: function () { return select_1.parseCapabilityQuery; } });
+Object.defineProperty(exports, "selectModels", { enumerable: true, get: function () { return select_1.selectModels; } });
+Object.defineProperty(exports, "hasCapability", { enumerable: true, get: function () { return select_1.hasCapability; } });
+Object.defineProperty(exports, "explainEmptySelection", { enumerable: true, get: function () { return select_1.explainEmptySelection; } });
+Object.defineProperty(exports, "ALL_CAPABILITY_PREDICATES", { enumerable: true, get: function () { return select_1.ALL_CAPABILITY_PREDICATES; } });
+Object.defineProperty(exports, "PREDICATE_GLOSS", { enumerable: true, get: function () { return select_1.PREDICATE_GLOSS; } });
+var call_notes_1 = require("./registry/call-notes");
+Object.defineProperty(exports, "callNotesFor", { enumerable: true, get: function () { return call_notes_1.callNotesFor; } });
+var staleness_1 = require("./registry/staleness");
+Object.defineProperty(exports, "probeFreshness", { enumerable: true, get: function () { return staleness_1.probeFreshness; } });
+Object.defineProperty(exports, "stalenessSentence", { enumerable: true, get: function () { return staleness_1.stalenessSentence; } });
+Object.defineProperty(exports, "PROBE_FRESHNESS_SLO_DAYS", { enumerable: true, get: function () { return staleness_1.PROBE_FRESHNESS_SLO_DAYS; } });
+var claims_1 = require("./registry/claims");
+Object.defineProperty(exports, "factsFor", { enumerable: true, get: function () { return claims_1.factsFor; } });
+Object.defineProperty(exports, "factsUnderCredential", { enumerable: true, get: function () { return claims_1.factsUnderCredential; } });
+var parity_1 = require("./registry/parity");
+Object.defineProperty(exports, "computeParity", { enumerable: true, get: function () { return parity_1.computeParity; } });
+var provider_2 = require("./types/provider");
+Object.defineProperty(exports, "ALL_CAPABILITY_FLAGS", { enumerable: true, get: function () { return provider_2.ALL_CAPABILITY_FLAGS; } });
+var feedback_2 = require("./feedback/feedback");
+Object.defineProperty(exports, "buildFeedbackRow", { enumerable: true, get: function () { return feedback_2.buildFeedbackRow; } });
+var coverage_1 = require("./feedback/coverage");
+Object.defineProperty(exports, "computeCoverage", { enumerable: true, get: function () { return coverage_1.computeCoverage; } });
+Object.defineProperty(exports, "RUNG1_MIN_FEEDBACK", { enumerable: true, get: function () { return coverage_1.RUNG1_MIN_FEEDBACK; } });
+// Watch loop + proposals (Phase 4 WS1).
+var evaluate_1 = require("./watch/evaluate");
+Object.defineProperty(exports, "evaluateEvents", { enumerable: true, get: function () { return evaluate_1.evaluateEvents; } });
+Object.defineProperty(exports, "triggerHash", { enumerable: true, get: function () { return evaluate_1.triggerHash; } });
+Object.defineProperty(exports, "PROPOSAL_TTL_DAYS", { enumerable: true, get: function () { return evaluate_1.PROPOSAL_TTL_DAYS; } });
+var proposals_1 = require("./watch/proposals");
+Object.defineProperty(exports, "createProposalsClient", { enumerable: true, get: function () { return proposals_1.createProposalsClient; } });
+Object.defineProperty(exports, "assertTransition", { enumerable: true, get: function () { return proposals_1.assertTransition; } });
+var run_3 = require("./watch/run");
+Object.defineProperty(exports, "runWatchCycle", { enumerable: true, get: function () { return run_3.runWatchCycle; } });
+var state_1 = require("./watch/state");
+Object.defineProperty(exports, "buildPriceUniverse", { enumerable: true, get: function () { return state_1.buildPriceUniverse; } });
+Object.defineProperty(exports, "computeWatchEvents", { enumerable: true, get: function () { return state_1.computeWatchEvents; } });
+Object.defineProperty(exports, "loadWatchState", { enumerable: true, get: function () { return state_1.loadWatchState; } });
+Object.defineProperty(exports, "saveWatchState", { enumerable: true, get: function () { return state_1.saveWatchState; } });
+// Durable watch state (addendum A4) — cron containers are ephemeral.
+var state_store_1 = require("./watch/state-store");
+Object.defineProperty(exports, "createWatchStateStore", { enumerable: true, get: function () { return state_store_1.createWatchStateStore; } });
+Object.defineProperty(exports, "createControlPlaneWatchStateStore", { enumerable: true, get: function () { return state_store_1.createControlPlaneWatchStateStore; } });
+Object.defineProperty(exports, "createFileWatchStateStore", { enumerable: true, get: function () { return state_store_1.createFileWatchStateStore; } });
+Object.defineProperty(exports, "WATCH_STATE_KEY", { enumerable: true, get: function () { return state_store_1.WATCH_STATE_KEY; } });
+var budget_1 = require("./watch/budget");
+Object.defineProperty(exports, "reserveWatchBudget", { enumerable: true, get: function () { return budget_1.reserveWatchBudget; } });
+Object.defineProperty(exports, "watchEnvelopeKey", { enumerable: true, get: function () { return budget_1.watchEnvelopeKey; } });
+Object.defineProperty(exports, "DEFAULT_WATCH_MONTHLY_USD", { enumerable: true, get: function () { return budget_1.DEFAULT_WATCH_MONTHLY_USD; } });
+// Matrix aggregation (Phase 4 WS6 — gated groundwork; no UI, deny-all RLS).
+var aggregate_1 = require("./matrix/aggregate");
+Object.defineProperty(exports, "aggregatePriors", { enumerable: true, get: function () { return aggregate_1.aggregatePriors; } });
+Object.defineProperty(exports, "aggregatePairwiseFromTelemetry", { enumerable: true, get: function () { return aggregate_1.aggregatePairwiseFromTelemetry; } });
+Object.defineProperty(exports, "writePriorsCells", { enumerable: true, get: function () { return aggregate_1.writePriorsCells; } });
+// Telemetry query surface (Phase 4 WS5).
+var grammar_1 = require("./query/grammar");
+Object.defineProperty(exports, "compileQuery", { enumerable: true, get: function () { return grammar_1.compileQuery; } });
+Object.defineProperty(exports, "QueryGrammarError", { enumerable: true, get: function () { return grammar_1.QueryGrammarError; } });
+var run_4 = require("./query/run");
+Object.defineProperty(exports, "runTelemetryQuery", { enumerable: true, get: function () { return run_4.runTelemetryQuery; } });
+// Savings odometer + swap machinery (Phase 4 WS4).
+var emit_1 = require("./savings/emit");
+Object.defineProperty(exports, "buildSwapChange", { enumerable: true, get: function () { return emit_1.buildSwapChange; } });
+var swap_execute_1 = require("./savings/swap-execute");
+Object.defineProperty(exports, "executeSwap", { enumerable: true, get: function () { return swap_execute_1.executeSwap; } });
+var swaps_client_1 = require("./savings/swaps-client");
+Object.defineProperty(exports, "createSwapsClient", { enumerable: true, get: function () { return swaps_client_1.createSwapsClient; } });
+var odometer_1 = require("./savings/odometer");
+Object.defineProperty(exports, "computeOdometer", { enumerable: true, get: function () { return odometer_1.computeOdometer; } });

package/dist/init/finder.d.ts

@@ -0,0 +1,79 @@
+/**
+ * Provider call-site finder — `modelrig init` v0 (spec WS2).
+ *
+ * AST-lite on purpose: a balanced-brace reader over the call's options
+ * object, not a TypeScript parser. The job is to find call sites and read
+ * the handful of literals that matter (model, system prompt, schema hint,
+ * generation params) well enough to DRAFT a route a human will review. It is
+ * allowed to be unsure — every uncertainty is recorded as a `note` on the
+ * site rather than guessed into the output, because a confident wrong draft
+ * is worse than an honest incomplete one.
+ *
+ * Generic by construction: everything provider-specific lives in
+ * signatures.ts. No repo, framework, or company is special-cased.
+ */
+export interface CallSiteParams {
+    readonly temperature?: number;
+    readonly topP?: number;
+    readonly maxTokens?: number;
+    readonly timeoutMs?: number;
+}
+export interface CallSite {
+    readonly file: string;
+    /** 1-indexed line of the call expression. */
+    readonly line: number;
+    readonly provider: string;
+    /** Model id when it was a literal; null when it came from a variable. */
+    readonly model: string | null;
+    /** The identifier the model came from, when it wasn't a literal. */
+    readonly modelExpression: string | null;
+    /** Literal system prompt when inline; null when referenced or absent. */
+    readonly systemPrompt: string | null;
+    /** The caller asked for structured output (schema/JSON mode present). */
+    readonly wantsStructuredOutput: boolean;
+    /** How the schema was expressed, when we could tell: zod | json-schema | json-mode. */
+    readonly schemaHint: string | null;
+    readonly params: CallSiteParams;
+    /** How the site was recognized — SDK call shape, or the API host. */
+    readonly matchedBy: "sdk" | "host";
+    /** Honest uncertainties for the human reviewing the draft. */
+    readonly notes: readonly string[];
+}
+export interface FinderOptions {
+    /** Skip these directory names anywhere in the tree. */
+    readonly skipDirs?: readonly string[];
+    readonly extensions?: readonly string[];
+    /** Include test files. Off by default: a mock is not a call site. */
+    readonly includeTests?: boolean;
+    readonly maxFileBytes?: number;
+}
+export declare const DEFAULT_SKIP_DIRS: readonly string[];
+export interface FileSystemLike {
+    readdirSync(path: string, options: {
+        withFileTypes: true;
+    }): Array<{
+        name: string;
+        isDirectory(): boolean;
+        isFile(): boolean;
+    }>;
+    readFileSync(path: string, encoding: "utf8"): string;
+    statSync(path: string): {
+        size: number;
+    };
+}
+/** Read the balanced `{...}` object starting at or after `from`. Returns null
+ * when the call has no object literal (e.g. a spread or a variable). */
+export declare function readObjectLiteral(source: string, from: number): string | null;
+/** Find provider call sites in one file's text. Exported for fixtures. */
+export declare function findCallSitesInText(file: string, fileText: string): CallSite[];
+export interface ScanResult {
+    readonly sites: readonly CallSite[];
+    readonly filesScanned: number;
+    /** Files skipped for size — reported, never silently dropped. */
+    readonly filesSkipped: readonly string[];
+}
+export declare function scanRepoForCallSites(root: string, fs: FileSystemLike, path: {
+    join: (...parts: string[]) => string;
+    relative: (from: string, to: string) => string;
+}, options?: FinderOptions): ScanResult;
+//# sourceMappingURL=finder.d.ts.map

package/dist/init/finder.d.ts.map

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