opensquid 0.5.395

package/dist/models/cost_router.d.ts

@@ -0,0 +1,116 @@
+/**
+ * Cross-subscription cost routing (AUTO.7).
+ *
+ * Authoritative source: `docs/tasks/automation.md` §"Task AUTO.7" +
+ * `docs/opensquid-real-design.md` §"Two-stage wedge gate" + memory
+ * `project_opensquid_multi_subscription_gateway`.
+ *
+ * Jobs (schedules, webhooks, inbound triggers, file-change watchers) can
+ * declare `cost_tier: cheap | balanced | premium` in their trigger block
+ * (accepted on the Zod schema since AUTO.1; see `runtime/event.ts`). The
+ * user declares concrete `subscription_pools:` per tier in
+ * `~/.opensquid/config.yaml`. `pick(tier)` selects one alias via
+ * round-robin within the tier, skipping pools that are currently
+ * rate-limited.
+ *
+ * Locked rules (per spec §"learn"):
+ *
+ *   1. NO implicit cross-tier upgrade. Empty tier OR all-pools-rate-limited
+ *      → THROW. Upgrade is the user's decision surfaced via audit log +
+ *      Stage 2 wedge recommendation (`cost_outcome.ts`).
+ *   2. Empty tier = config error → `EmptyTierError`. Fail-loud posture.
+ *   3. Round-robin within tier (per-tier cursor). Rate-limited pools are
+ *      skipped but re-enter rotation as soon as the probe clears.
+ *   4. Rate-limit awareness via injected `isRateLimited(alias)` probe — the
+ *      router never imports RateLimiter; the caller wires it.
+ *   5. Audit log: every `pick()` decision records (tier, alias, success,
+ *      reason?) via an injected sink. Engine-vocabulary discipline matches
+ *      `RateLimiter.onError`.
+ *   6. `recordOutcome` forwards (alias, success, latencyMs) to a sink that
+ *      ultimately reaches `cost_outcome.ts` (Stage 2).
+ *
+ * Anti-self-grading invariant: no LLM primitive call in this file. Decision
+ * inputs are EXTERNAL — rate-limit probe + caller-supplied user signal.
+ * The audit-grep that anchors promote.ts's moat covers this file too.
+ *
+ * Imports from: nothing. Imported by: src/runtime/bootstrap.ts (future).
+ */
+export type CostTier = 'cheap' | 'balanced' | 'premium';
+/**
+ * One concrete subscription endpoint. `alias` is the model-alias name
+ * resolved by ModelDispatcher; `provider` + `model` are audit-only at the
+ * router layer (dispatcher branches on (mode, impl)). `rateLimit` is
+ * consumed by the upstream probe — local/ollama pools typically omit it.
+ */
+export interface SubscriptionPool {
+    alias: string;
+    provider: string;
+    model: string;
+    rateLimit?: {
+        rpm: number;
+        tpm?: number;
+    };
+}
+/**
+ * One `pick()` decision. `success=false` means the router threw
+ * EmptyTierError (no pools or all rate-limited). Callers persist these
+ * for `opensquid cost routing` to surface tier-bleed.
+ */
+export interface CostRoutingAuditEntry {
+    tier: CostTier;
+    alias: string | null;
+    success: boolean;
+    reason?: 'empty_tier' | 'all_rate_limited';
+    timestamp: string;
+}
+/** Per-dispatch outcome record forwarded to Stage 2 (cost_outcome.ts). */
+export interface CostOutcomeRecord {
+    alias: string;
+    success: boolean;
+    latencyMs: number;
+    timestamp: string;
+}
+export interface CostRouterOpts {
+    /** Per-tier pools. Missing tier → empty (any `pick()` throws). */
+    pools: Partial<Record<CostTier, SubscriptionPool[]>>;
+    /** `true` = pool is currently rate-limited, skip it. Default: never. */
+    isRateLimited?: (alias: string) => boolean;
+    /** Audit sink; default no-op so callers can opt out. */
+    audit?: (entry: CostRoutingAuditEntry) => void;
+    /** Outcome sink for Stage 2; default no-op. */
+    outcome?: (entry: CostOutcomeRecord) => void;
+    /** Injected clock — every test passes a fake `now`. */
+    now?: () => number;
+}
+export declare class EmptyTierError extends Error {
+    tier: CostTier;
+    reason: 'empty_tier' | 'all_rate_limited';
+    constructor(tier: CostTier, reason: 'empty_tier' | 'all_rate_limited');
+}
+/**
+ * Round-robin within tier with rate-limit-aware skipping. No implicit
+ * cross-tier upgrade. Fail-loud on empty tier.
+ */
+export declare class CostRouter {
+    private opts;
+    private cursors;
+    private isRateLimited;
+    private auditSink;
+    private outcomeSink;
+    private now;
+    constructor(opts: CostRouterOpts);
+    /**
+     * Pick one alias from the requested tier. Round-robin cursor advances
+     * each call so consecutive calls rotate. Rate-limited pools are skipped;
+     * if every pool is rate-limited, throws EmptyTierError rather than
+     * upgrading to a higher tier.
+     */
+    pick(tier: CostTier): string;
+    /**
+     * Record a dispatch outcome → Stage 2 wedge gate (cost_outcome.ts).
+     * Async signature matches the spec's "Key code shapes" — body forwards
+     * synchronously to the sink, which owns any persistence I/O.
+     */
+    recordOutcome(alias: string, success: boolean, latencyMs: number): Promise<void>;
+}
+//# sourceMappingURL=cost_router.d.ts.map

package/dist/models/cost_router.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cost_router.d.ts","sourceRoot":"","sources":["../../src/models/cost_router.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AAEH,MAAM,MAAM,QAAQ,GAAG,OAAO,GAAG,UAAU,GAAG,SAAS,CAAC;AAExD;;;;;GAKG;AACH,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,GAAG,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CAC3C;AAED;;;;GAIG;AACH,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,QAAQ,CAAC;IACf,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,CAAC,EAAE,YAAY,GAAG,kBAAkB,CAAC;IAC3C,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,0EAA0E;AAC1E,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,cAAc;IAC7B,kEAAkE;IAClE,KAAK,EAAE,OAAO,CAAC,MAAM,CAAC,QAAQ,EAAE,gBAAgB,EAAE,CAAC,CAAC,CAAC;IACrD,wEAAwE;IACxE,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC;IAC3C,wDAAwD;IACxD,KAAK,CAAC,EAAE,CAAC,KAAK,EAAE,qBAAqB,KAAK,IAAI,CAAC;IAC/C,+CAA+C;IAC/C,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,iBAAiB,KAAK,IAAI,CAAC;IAC7C,uDAAuD;IACvD,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;CACpB;AAED,qBAAa,cAAe,SAAQ,KAAK;IAE9B,IAAI,EAAE,QAAQ;IACd,MAAM,EAAE,YAAY,GAAG,kBAAkB;gBADzC,IAAI,EAAE,QAAQ,EACd,MAAM,EAAE,YAAY,GAAG,kBAAkB;CASnD;AAED;;;GAGG;AACH,qBAAa,UAAU;IAOT,OAAO,CAAC,IAAI;IANxB,OAAO,CAAC,OAAO,CAAmE;IAClF,OAAO,CAAC,aAAa,CAA6B;IAClD,OAAO,CAAC,SAAS,CAAyC;IAC1D,OAAO,CAAC,WAAW,CAAqC;IACxD,OAAO,CAAC,GAAG,CAAe;gBAEN,IAAI,EAAE,cAAc;IAOxC;;;;;OAKG;IACH,IAAI,CAAC,IAAI,EAAE,QAAQ,GAAG,MAAM;IAuC5B;;;;OAIG;IACH,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CASjF"}

package/dist/models/cost_router.js

@@ -0,0 +1,127 @@
+/**
+ * Cross-subscription cost routing (AUTO.7).
+ *
+ * Authoritative source: `docs/tasks/automation.md` §"Task AUTO.7" +
+ * `docs/opensquid-real-design.md` §"Two-stage wedge gate" + memory
+ * `project_opensquid_multi_subscription_gateway`.
+ *
+ * Jobs (schedules, webhooks, inbound triggers, file-change watchers) can
+ * declare `cost_tier: cheap | balanced | premium` in their trigger block
+ * (accepted on the Zod schema since AUTO.1; see `runtime/event.ts`). The
+ * user declares concrete `subscription_pools:` per tier in
+ * `~/.opensquid/config.yaml`. `pick(tier)` selects one alias via
+ * round-robin within the tier, skipping pools that are currently
+ * rate-limited.
+ *
+ * Locked rules (per spec §"learn"):
+ *
+ *   1. NO implicit cross-tier upgrade. Empty tier OR all-pools-rate-limited
+ *      → THROW. Upgrade is the user's decision surfaced via audit log +
+ *      Stage 2 wedge recommendation (`cost_outcome.ts`).
+ *   2. Empty tier = config error → `EmptyTierError`. Fail-loud posture.
+ *   3. Round-robin within tier (per-tier cursor). Rate-limited pools are
+ *      skipped but re-enter rotation as soon as the probe clears.
+ *   4. Rate-limit awareness via injected `isRateLimited(alias)` probe — the
+ *      router never imports RateLimiter; the caller wires it.
+ *   5. Audit log: every `pick()` decision records (tier, alias, success,
+ *      reason?) via an injected sink. Engine-vocabulary discipline matches
+ *      `RateLimiter.onError`.
+ *   6. `recordOutcome` forwards (alias, success, latencyMs) to a sink that
+ *      ultimately reaches `cost_outcome.ts` (Stage 2).
+ *
+ * Anti-self-grading invariant: no LLM primitive call in this file. Decision
+ * inputs are EXTERNAL — rate-limit probe + caller-supplied user signal.
+ * The audit-grep that anchors promote.ts's moat covers this file too.
+ *
+ * Imports from: nothing. Imported by: src/runtime/bootstrap.ts (future).
+ */
+export class EmptyTierError extends Error {
+    tier;
+    reason;
+    constructor(tier, reason) {
+        super(reason === 'empty_tier'
+            ? `cost tier "${tier}" has no configured subscription pools — declare at least one in ~/.opensquid/config.yaml subscription_pools.${tier}`
+            : `cost tier "${tier}" has pools but all are rate-limited — no implicit upgrade (locked: AUTO.7 §learn rule 1)`);
+        this.tier = tier;
+        this.reason = reason;
+        this.name = 'EmptyTierError';
+    }
+}
+/**
+ * Round-robin within tier with rate-limit-aware skipping. No implicit
+ * cross-tier upgrade. Fail-loud on empty tier.
+ */
+export class CostRouter {
+    opts;
+    cursors = { cheap: 0, balanced: 0, premium: 0 };
+    isRateLimited;
+    auditSink;
+    outcomeSink;
+    now;
+    constructor(opts) {
+        this.opts = opts;
+        this.isRateLimited = opts.isRateLimited ?? (() => false);
+        this.auditSink = opts.audit ?? (() => undefined);
+        this.outcomeSink = opts.outcome ?? (() => undefined);
+        this.now = opts.now ?? Date.now;
+    }
+    /**
+     * Pick one alias from the requested tier. Round-robin cursor advances
+     * each call so consecutive calls rotate. Rate-limited pools are skipped;
+     * if every pool is rate-limited, throws EmptyTierError rather than
+     * upgrading to a higher tier.
+     */
+    pick(tier) {
+        const tierPools = this.opts.pools[tier] ?? [];
+        if (tierPools.length === 0) {
+            this.auditSink({
+                tier,
+                alias: null,
+                success: false,
+                reason: 'empty_tier',
+                timestamp: new Date(this.now()).toISOString(),
+            });
+            throw new EmptyTierError(tier, 'empty_tier');
+        }
+        const start = this.cursors[tier] % tierPools.length;
+        for (let i = 0; i < tierPools.length; i++) {
+            const idx = (start + i) % tierPools.length;
+            const pool = tierPools[idx];
+            if (pool === undefined)
+                continue;
+            if (this.isRateLimited(pool.alias))
+                continue;
+            this.cursors[tier] = (idx + 1) % tierPools.length;
+            this.auditSink({
+                tier,
+                alias: pool.alias,
+                success: true,
+                timestamp: new Date(this.now()).toISOString(),
+            });
+            return pool.alias;
+        }
+        this.auditSink({
+            tier,
+            alias: null,
+            success: false,
+            reason: 'all_rate_limited',
+            timestamp: new Date(this.now()).toISOString(),
+        });
+        throw new EmptyTierError(tier, 'all_rate_limited');
+    }
+    /**
+     * Record a dispatch outcome → Stage 2 wedge gate (cost_outcome.ts).
+     * Async signature matches the spec's "Key code shapes" — body forwards
+     * synchronously to the sink, which owns any persistence I/O.
+     */
+    recordOutcome(alias, success, latencyMs) {
+        this.outcomeSink({
+            alias,
+            success,
+            latencyMs,
+            timestamp: new Date(this.now()).toISOString(),
+        });
+        return Promise.resolve();
+    }
+}
+//# sourceMappingURL=cost_router.js.map

package/dist/models/cost_router.js.map

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

package/dist/models/dispatcher.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Alias → strategy resolver. Branches on `(mode, impl)` and dispatches to
+ * the matching strategy module. The dispatcher is a pure function: no
+ * state, no side effects. It owns ONE decision — given a config, which
+ * strategy handles it. Strategy modules own the actual call mechanics.
+ *
+ * Model neutrality surface: this file branches on abstract mode names
+ * (`subscription`, `api`, `local`, `mcp`) and abstract impl names
+ * (`cli`, `sdk`), never on vendor identity. The provider split for `api`
+ * mode reads `cfg.provider` (a user-supplied string), so even there no
+ * vendor name is hardcoded — providers compare against the abstract
+ * label users wrote in `models.yaml`.
+ *
+ * Mode coverage (post LLM.4 — all five modes now concrete):
+ *   - (subscription, cli)            → subscriptionCliStrategy
+ *   - (subscription, sdk)            → subscriptionSdkStrategy
+ *   - (api, *), provider=anthropic   → apiAnthropicStrategy (needs secrets)
+ *   - (api, *), provider=openai      → apiOpenAIStrategy    (needs secrets)
+ *   - (local, *)                     → localOllamaStrategy (Ollama is the
+ *                                       only Phase-1 local impl)
+ *   - (mcp, *)                       → mcpStrategy (fail-fasts on missing
+ *                                       server/tool at factory time)
+ *
+ * Secrets dependency:
+ *   API strategies need a `SecretResolver` to read the user's API key.
+ *   `resolveStrategy` accepts it as an optional second parameter so the
+ *   existing (subscription, cli) and (subscription, sdk) callers don't
+ *   have to thread it. If a user picks api mode without passing secrets,
+ *   the resolver throws at resolve time — a config error, not a runtime
+ *   surprise on first call.
+ *
+ * Imports from: ./types.js, ./strategies/*.js, ../secrets/types.js.
+ * Imported by: functions/llm.ts.
+ */
+import type { SecretResolver } from '../secrets/types.js';
+import type { ModelAliasConfig, ModelStrategy } from './types.js';
+export declare function resolveStrategy(alias: string, config: ModelAliasConfig, secrets?: SecretResolver): ModelStrategy;
+//# sourceMappingURL=dispatcher.d.ts.map

package/dist/models/dispatcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dispatcher.d.ts","sourceRoot":"","sources":["../../src/models/dispatcher.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAS1D,OAAO,KAAK,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAElE,wBAAgB,eAAe,CAC7B,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,gBAAgB,EACxB,OAAO,CAAC,EAAE,cAAc,GACvB,aAAa,CAqCf"}

package/dist/models/dispatcher.js

@@ -0,0 +1,76 @@
+/**
+ * Alias → strategy resolver. Branches on `(mode, impl)` and dispatches to
+ * the matching strategy module. The dispatcher is a pure function: no
+ * state, no side effects. It owns ONE decision — given a config, which
+ * strategy handles it. Strategy modules own the actual call mechanics.
+ *
+ * Model neutrality surface: this file branches on abstract mode names
+ * (`subscription`, `api`, `local`, `mcp`) and abstract impl names
+ * (`cli`, `sdk`), never on vendor identity. The provider split for `api`
+ * mode reads `cfg.provider` (a user-supplied string), so even there no
+ * vendor name is hardcoded — providers compare against the abstract
+ * label users wrote in `models.yaml`.
+ *
+ * Mode coverage (post LLM.4 — all five modes now concrete):
+ *   - (subscription, cli)            → subscriptionCliStrategy
+ *   - (subscription, sdk)            → subscriptionSdkStrategy
+ *   - (api, *), provider=anthropic   → apiAnthropicStrategy (needs secrets)
+ *   - (api, *), provider=openai      → apiOpenAIStrategy    (needs secrets)
+ *   - (local, *)                     → localOllamaStrategy (Ollama is the
+ *                                       only Phase-1 local impl)
+ *   - (mcp, *)                       → mcpStrategy (fail-fasts on missing
+ *                                       server/tool at factory time)
+ *
+ * Secrets dependency:
+ *   API strategies need a `SecretResolver` to read the user's API key.
+ *   `resolveStrategy` accepts it as an optional second parameter so the
+ *   existing (subscription, cli) and (subscription, sdk) callers don't
+ *   have to thread it. If a user picks api mode without passing secrets,
+ *   the resolver throws at resolve time — a config error, not a runtime
+ *   surprise on first call.
+ *
+ * Imports from: ./types.js, ./strategies/*.js, ../secrets/types.js.
+ * Imported by: functions/llm.ts.
+ */
+import { apiAnthropicStrategy } from './strategies/api_anthropic.js';
+import { apiOpenAIStrategy } from './strategies/api_openai.js';
+import { localOllamaStrategy } from './strategies/local_ollama.js';
+import { mcpStrategy } from './strategies/mcp.js';
+import { stubStrategy } from './strategies/_stub.js';
+import { subscriptionCliStrategy } from './strategies/subscription_cli.js';
+import { subscriptionSdkStrategy } from './strategies/subscription_sdk.js';
+export function resolveStrategy(alias, config, secrets) {
+    if (config.mode === 'subscription' && config.impl === 'cli') {
+        return subscriptionCliStrategy(config);
+    }
+    if (config.mode === 'subscription' && config.impl === 'sdk') {
+        return subscriptionSdkStrategy(config);
+    }
+    if (config.mode === 'api') {
+        if (!secrets) {
+            throw new Error(`Model alias "${alias}": api mode requires a SecretResolver to read the API key`);
+        }
+        if (config.provider === 'anthropic') {
+            return apiAnthropicStrategy(config, secrets);
+        }
+        if (config.provider === 'openai') {
+            return apiOpenAIStrategy(config, secrets);
+        }
+        throw new Error(`Model alias "${alias}": api mode requires \`provider\` to be one of "anthropic" | "openai" ` +
+            `(got ${config.provider === undefined ? 'undefined' : `"${config.provider}"`})`);
+    }
+    if (config.mode === 'local') {
+        // Phase 1: Ollama is the only `local` implementation. Future engines
+        // (llama.cpp, vLLM, MLX) would branch on cfg.provider here.
+        return localOllamaStrategy(config);
+    }
+    if (config.mode === 'mcp') {
+        // mcp strategy fail-fasts on missing server/tool at factory time —
+        // resolve here surfaces config errors at pack-load.
+        return mcpStrategy(config);
+    }
+    // Unknown mode (shouldn't be reachable given ModelMode union, but the
+    // stub is a safe fallback).
+    return stubStrategy(alias, config.mode);
+}
+//# sourceMappingURL=dispatcher.js.map

package/dist/models/dispatcher.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dispatcher.js","sourceRoot":"","sources":["../../src/models/dispatcher.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AAIH,OAAO,EAAE,oBAAoB,EAAE,MAAM,+BAA+B,CAAC;AACrE,OAAO,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AAC/D,OAAO,EAAE,mBAAmB,EAAE,MAAM,8BAA8B,CAAC;AACnE,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAClD,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AACrD,OAAO,EAAE,uBAAuB,EAAE,MAAM,kCAAkC,CAAC;AAC3E,OAAO,EAAE,uBAAuB,EAAE,MAAM,kCAAkC,CAAC;AAG3E,MAAM,UAAU,eAAe,CAC7B,KAAa,EACb,MAAwB,EACxB,OAAwB;IAExB,IAAI,MAAM,CAAC,IAAI,KAAK,cAAc,IAAI,MAAM,CAAC,IAAI,KAAK,KAAK,EAAE,CAAC;QAC5D,OAAO,uBAAuB,CAAC,MAAM,CAAC,CAAC;IACzC,CAAC;IACD,IAAI,MAAM,CAAC,IAAI,KAAK,cAAc,IAAI,MAAM,CAAC,IAAI,KAAK,KAAK,EAAE,CAAC;QAC5D,OAAO,uBAAuB,CAAC,MAAM,CAAC,CAAC;IACzC,CAAC;IACD,IAAI,MAAM,CAAC,IAAI,KAAK,KAAK,EAAE,CAAC;QAC1B,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,MAAM,IAAI,KAAK,CACb,gBAAgB,KAAK,2DAA2D,CACjF,CAAC;QACJ,CAAC;QACD,IAAI,MAAM,CAAC,QAAQ,KAAK,WAAW,EAAE,CAAC;YACpC,OAAO,oBAAoB,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAC/C,CAAC;QACD,IAAI,MAAM,CAAC,QAAQ,KAAK,QAAQ,EAAE,CAAC;YACjC,OAAO,iBAAiB,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAC5C,CAAC;QACD,MAAM,IAAI,KAAK,CACb,gBAAgB,KAAK,wEAAwE;YAC3F,QAAQ,MAAM,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,IAAI,MAAM,CAAC,QAAQ,GAAG,GAAG,CAClF,CAAC;IACJ,CAAC;IACD,IAAI,MAAM,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC;QAC5B,qEAAqE;QACrE,4DAA4D;QAC5D,OAAO,mBAAmB,CAAC,MAAM,CAAC,CAAC;IACrC,CAAC;IACD,IAAI,MAAM,CAAC,IAAI,KAAK,KAAK,EAAE,CAAC;QAC1B,mEAAmE;QACnE,oDAAoD;QACpD,OAAO,WAAW,CAAC,MAAM,CAAC,CAAC;IAC7B,CAAC;IACD,sEAAsE;IACtE,4BAA4B;IAC5B,OAAO,YAAY,CAAC,KAAK,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC;AAC1C,CAAC"}

package/dist/models/index.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Models: model-alias dispatch routing pack-declared aliases to the user's
+ * configured backend (subscription CLI, SDK, API, local Ollama, MCP).
+ *
+ * Imports from: nothing in src/ (sibling layer).
+ * Imported by: runtime/, setup/, mcp/, functions/llm.ts.
+ */
+export type { ModelAliasConfig, ModelImpl, ModelMode, ModelStrategy } from './types.js';
+export { resolveStrategy } from './dispatcher.js';
+export { loadModelsConfig } from './load_config.js';
+export { CostRouter, EmptyTierError, type CostOutcomeRecord, type CostRoutingAuditEntry, type CostRouterOpts, type CostTier, type SubscriptionPool, } from './cost_router.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/models/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/models/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,YAAY,EAAE,gBAAgB,EAAE,SAAS,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AACxF,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAGpD,OAAO,EACL,UAAU,EACV,cAAc,EACd,KAAK,iBAAiB,EACtB,KAAK,qBAAqB,EAC1B,KAAK,cAAc,EACnB,KAAK,QAAQ,EACb,KAAK,gBAAgB,GACtB,MAAM,kBAAkB,CAAC"}

package/dist/models/index.js

@@ -0,0 +1,5 @@
+export { resolveStrategy } from './dispatcher.js';
+export { loadModelsConfig } from './load_config.js';
+// AUTO.7 — cross-subscription cost routing
+export { CostRouter, EmptyTierError, } from './cost_router.js';
+//# sourceMappingURL=index.js.map

package/dist/models/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/models/index.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAEpD,2CAA2C;AAC3C,OAAO,EACL,UAAU,EACV,cAAc,GAMf,MAAM,kBAAkB,CAAC"}

package/dist/models/load_config.d.ts

@@ -0,0 +1,51 @@
+/**
+ * Models config loader — three-source precedence resolver (PR-followup).
+ *
+ * Precedence (highest → lowest):
+ *
+ *   1. `OPENSQUID_MODELS_CONFIG_INLINE` env var (JSON object) — test seam +
+ *      Phase 1 power-user override. Same shape as the Phase-1 stub.
+ *   2. User-level `~/.opensquid/models.yaml` — the user's persistent override
+ *      file. WIRED (T-FLOW-UNSKIPPABLE F0c): read + schema-validated here, merged
+ *      over the pack layer. Lets a user pin a vendor binding without editing every
+ *      pack. (Previously reserved/unwired — which silently broke every pack alias
+ *      the user defined only at this layer, e.g. `reasoning`, so the audit subagents
+ *      failed `arg_invalid` and the coding-flow FSM could never advance.)
+ *   3. Pack-shipped `models.yaml` — folded into `Pack.models` by the loader
+ *      (PR-followup). Acts as the out-of-the-box default for any alias a
+ *      pack references; the user can override per-alias via layer 2 (or
+ *      per-call via layer 1 for tests).
+ *   4. Empty record — downstream callers report `Unknown model alias`.
+ *
+ * Why a pack-aware resolver beats the Phase-1 stub: packs DECLARE their
+ * alias contract in their own `models.yaml` (`fast_classifier: { mode: ...
+ * impl: cli, cli: claude }` etc.) so a pack can ship with sensible defaults
+ * out of the box. Without this layer, every pack required the user to
+ * pre-author a user-level `models.yaml` BEFORE any rule could fire — the
+ * "models.yaml present but ignored" UX surfaced in the PR.7 closure.
+ *
+ * The `packModels` arg is intentionally optional + only-merge-when-defined
+ * so the env-var test seam keeps its existing one-arg behavior — no
+ * existing test needs touching. Callers that have access to the active
+ * pack list (`functions/llm.ts` via `EvalCtx`) thread the pack-shipped
+ * models through; callers that don't (legacy daemon startup) get the
+ * pre-PR-followup behavior.
+ *
+ * Env-var injection mirrors `OPENSQUID_HOME` (see `runtime/paths.ts`).
+ *
+ * Imports from: ./types.js.
+ * Imported by: functions/llm.ts, runtime/agent_bridge/daemon.ts,
+ *   setup/schedule_nl.ts.
+ */
+import { ModelsConfig } from '../packs/schemas/models.js';
+import type { ModelAliasConfig } from './types.js';
+/**
+ * Resolve the merged model-alias map for the current call.
+ *
+ * @param packModels optional pack-shipped models map (from `Pack.models`).
+ *                   When provided, used as the LOWEST-precedence layer; env
+ *                   var overrides any matching alias. When `undefined`, only
+ *                   the env-var stub contributes — preserves Phase 1 contract.
+ */
+export declare function loadModelsConfig(packModels?: ModelsConfig): Promise<Record<string, ModelAliasConfig>>;
+//# sourceMappingURL=load_config.d.ts.map

package/dist/models/load_config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"load_config.d.ts","sourceRoot":"","sources":["../../src/models/load_config.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG;AAOH,OAAO,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAG1D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAEnD;;;;;;;GAOG;AACH,wBAAsB,gBAAgB,CACpC,UAAU,CAAC,EAAE,YAAY,GACxB,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC,CA+C3C"}

package/dist/models/load_config.js

@@ -0,0 +1,99 @@
+/**
+ * Models config loader — three-source precedence resolver (PR-followup).
+ *
+ * Precedence (highest → lowest):
+ *
+ *   1. `OPENSQUID_MODELS_CONFIG_INLINE` env var (JSON object) — test seam +
+ *      Phase 1 power-user override. Same shape as the Phase-1 stub.
+ *   2. User-level `~/.opensquid/models.yaml` — the user's persistent override
+ *      file. WIRED (T-FLOW-UNSKIPPABLE F0c): read + schema-validated here, merged
+ *      over the pack layer. Lets a user pin a vendor binding without editing every
+ *      pack. (Previously reserved/unwired — which silently broke every pack alias
+ *      the user defined only at this layer, e.g. `reasoning`, so the audit subagents
+ *      failed `arg_invalid` and the coding-flow FSM could never advance.)
+ *   3. Pack-shipped `models.yaml` — folded into `Pack.models` by the loader
+ *      (PR-followup). Acts as the out-of-the-box default for any alias a
+ *      pack references; the user can override per-alias via layer 2 (or
+ *      per-call via layer 1 for tests).
+ *   4. Empty record — downstream callers report `Unknown model alias`.
+ *
+ * Why a pack-aware resolver beats the Phase-1 stub: packs DECLARE their
+ * alias contract in their own `models.yaml` (`fast_classifier: { mode: ...
+ * impl: cli, cli: claude }` etc.) so a pack can ship with sensible defaults
+ * out of the box. Without this layer, every pack required the user to
+ * pre-author a user-level `models.yaml` BEFORE any rule could fire — the
+ * "models.yaml present but ignored" UX surfaced in the PR.7 closure.
+ *
+ * The `packModels` arg is intentionally optional + only-merge-when-defined
+ * so the env-var test seam keeps its existing one-arg behavior — no
+ * existing test needs touching. Callers that have access to the active
+ * pack list (`functions/llm.ts` via `EvalCtx`) thread the pack-shipped
+ * models through; callers that don't (legacy daemon startup) get the
+ * pre-PR-followup behavior.
+ *
+ * Env-var injection mirrors `OPENSQUID_HOME` (see `runtime/paths.ts`).
+ *
+ * Imports from: ./types.js.
+ * Imported by: functions/llm.ts, runtime/agent_bridge/daemon.ts,
+ *   setup/schedule_nl.ts.
+ */
+import { readFile } from 'node:fs/promises';
+import { join } from 'node:path';
+import { parse as parseYaml } from 'yaml';
+import { ModelsConfig } from '../packs/schemas/models.js';
+import { OPENSQUID_HOME } from '../runtime/paths.js';
+/**
+ * Resolve the merged model-alias map for the current call.
+ *
+ * @param packModels optional pack-shipped models map (from `Pack.models`).
+ *                   When provided, used as the LOWEST-precedence layer; env
+ *                   var overrides any matching alias. When `undefined`, only
+ *                   the env-var stub contributes — preserves Phase 1 contract.
+ */
+export async function loadModelsConfig(packModels) {
+    // Layer 3 first (lowest precedence) — pack-shipped aliases provide the
+    // baseline. Spread into a fresh object so we never mutate the caller's
+    // Pack.models map.
+    const merged = packModels !== undefined
+        ? { ...packModels }
+        : {};
+    // Layer 2 (user-level YAML) — WIRED (T-FLOW-UNSKIPPABLE F0c). Read
+    // `~/.opensquid/models.yaml` and merge OVER the pack layer. Without this the
+    // runtime never consulted the user's file, so a pack alias like `reasoning`
+    // resolved to undefined → `subagent_call` failed `arg_invalid` → the
+    // guess/spec audits never ran → the coding-flow FSM was stuck at `scoping`
+    // forever (the flow was un-completable). Fail-SOFT: absent / unreadable /
+    // schema-invalid YAML is skipped (the resolver must NEVER throw — a model
+    // misconfig must not crash a hook). Validated via the same `ModelsConfig`
+    // schema the pack/wizard use.
+    try {
+        const raw = await readFile(join(OPENSQUID_HOME(), 'models.yaml'), 'utf8');
+        const parsed = ModelsConfig.safeParse(parseYaml(raw));
+        if (parsed.success) {
+            Object.assign(merged, parsed.data);
+        }
+    }
+    catch {
+        // absent / unreadable / invalid YAML → no user-level overrides
+    }
+    // Layer 1 (highest precedence) — env-var inline override. Always overrides
+    // pack-shipped + user-level entries for matching aliases; new aliases at
+    // this layer are accepted (tests inject ad-hoc aliases).
+    const inline = process.env.OPENSQUID_MODELS_CONFIG_INLINE;
+    if (inline !== undefined && inline.length > 0) {
+        try {
+            const parsed = JSON.parse(inline);
+            if (parsed !== null && typeof parsed === 'object' && !Array.isArray(parsed)) {
+                // Trust the shape — Phase 2's full schema-validated user-yaml loader
+                // will Zod-validate at the user-yaml layer. The env-var seam stays
+                // permissive so tests don't have to construct schema-compliant input.
+                Object.assign(merged, parsed);
+            }
+        }
+        catch {
+            // Fall through to whatever we already have from the pack layer.
+        }
+    }
+    return merged;
+}
+//# sourceMappingURL=load_config.js.map

package/dist/models/load_config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"load_config.js","sourceRoot":"","sources":["../../src/models/load_config.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,OAAO,EAAE,KAAK,IAAI,SAAS,EAAE,MAAM,MAAM,CAAC;AAE1C,OAAO,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAC1D,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAIrD;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,UAAyB;IAEzB,uEAAuE;IACvE,uEAAuE;IACvE,mBAAmB;IACnB,MAAM,MAAM,GACV,UAAU,KAAK,SAAS;QACtB,CAAC,CAAC,EAAE,GAAI,UAA0D,EAAE;QACpE,CAAC,CAAC,EAAE,CAAC;IAET,mEAAmE;IACnE,6EAA6E;IAC7E,4EAA4E;IAC5E,qEAAqE;IACrE,2EAA2E;IAC3E,0EAA0E;IAC1E,0EAA0E;IAC1E,0EAA0E;IAC1E,8BAA8B;IAC9B,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,MAAM,QAAQ,CAAC,IAAI,CAAC,cAAc,EAAE,EAAE,aAAa,CAAC,EAAE,MAAM,CAAC,CAAC;QAC1E,MAAM,MAAM,GAAG,YAAY,CAAC,SAAS,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC;QACtD,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;YACnB,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,IAAwC,CAAC,CAAC;QACzE,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,+DAA+D;IACjE,CAAC;IAED,2EAA2E;IAC3E,yEAAyE;IACzE,yDAAyD;IACzD,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,8BAA8B,CAAC;IAC1D,IAAI,MAAM,KAAK,SAAS,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC9C,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAY,CAAC;YAC7C,IAAI,MAAM,KAAK,IAAI,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;gBAC5E,qEAAqE;gBACrE,mEAAmE;gBACnE,sEAAsE;gBACtE,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,MAA0C,CAAC,CAAC;YACpE,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,gEAAgE;QAClE,CAAC;IACH,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/models/strategies/_stub.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Stub strategy for the four modes not yet implemented in Phase 1.
+ *
+ * The dispatcher resolves to this strategy when the alias's `(mode, impl)`
+ * combination isn't `(subscription, cli)`. Calling `.call()` on it rejects
+ * with a message naming the missing mode and the LLM.1–LLM.4 task slot
+ * that will implement it, so a user mis-configuring `models.yaml` gets a
+ * useful pointer instead of a silent stub.
+ *
+ * Deferred implementations (cross-cutting LLM track):
+ *   - LLM.1: subscription + sdk  (SDK-mode subagents, observes parent session)
+ *   - LLM.2: api                 (direct provider HTTP API w/ user's key)
+ *   - LLM.3: local               (Ollama, llama.cpp, etc. via local endpoint)
+ *   - LLM.4: mcp                 (delegate to an external MCP server)
+ *
+ * Model neutrality: this file names no vendors. Mode names are abstract.
+ *
+ * Imports from: ../types.js.
+ * Imported by: models/dispatcher.ts.
+ */
+import type { ModelMode, ModelStrategy } from '../types.js';
+export declare function stubStrategy(alias: string, mode: ModelMode): ModelStrategy;
+//# sourceMappingURL=_stub.d.ts.map

package/dist/models/strategies/_stub.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"_stub.d.ts","sourceRoot":"","sources":["../../../src/models/strategies/_stub.ts"],"names":[],"mappings":"AACA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAE5D,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,GAAG,aAAa,CAS1E"}

package/dist/models/strategies/_stub.js

@@ -0,0 +1,30 @@
+/* eslint-disable @typescript-eslint/require-await */
+/**
+ * Stub strategy for the four modes not yet implemented in Phase 1.
+ *
+ * The dispatcher resolves to this strategy when the alias's `(mode, impl)`
+ * combination isn't `(subscription, cli)`. Calling `.call()` on it rejects
+ * with a message naming the missing mode and the LLM.1–LLM.4 task slot
+ * that will implement it, so a user mis-configuring `models.yaml` gets a
+ * useful pointer instead of a silent stub.
+ *
+ * Deferred implementations (cross-cutting LLM track):
+ *   - LLM.1: subscription + sdk  (SDK-mode subagents, observes parent session)
+ *   - LLM.2: api                 (direct provider HTTP API w/ user's key)
+ *   - LLM.3: local               (Ollama, llama.cpp, etc. via local endpoint)
+ *   - LLM.4: mcp                 (delegate to an external MCP server)
+ *
+ * Model neutrality: this file names no vendors. Mode names are abstract.
+ *
+ * Imports from: ../types.js.
+ * Imported by: models/dispatcher.ts.
+ */
+export function stubStrategy(alias, mode) {
+    return {
+        async call() {
+            throw new Error(`Model alias "${alias}": mode "${mode}" strategy not yet implemented ` +
+                '(deferred to cross-cutting tasks LLM.1–LLM.4)');
+        },
+    };
+}
+//# sourceMappingURL=_stub.js.map

package/dist/models/strategies/_stub.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"_stub.js","sourceRoot":"","sources":["../../../src/models/strategies/_stub.ts"],"names":[],"mappings":"AAAA,qDAAqD;AACrD;;;;;;;;;;;;;;;;;;;GAmBG;AAIH,MAAM,UAAU,YAAY,CAAC,KAAa,EAAE,IAAe;IACzD,OAAO;QACL,KAAK,CAAC,IAAI;YACR,MAAM,IAAI,KAAK,CACb,gBAAgB,KAAK,YAAY,IAAI,iCAAiC;gBACpE,+CAA+C,CAClD,CAAC;QACJ,CAAC;KACF,CAAC;AACJ,CAAC"}