pi-smart-router 0.1.0

package/dist/domain/pinning/session-pinner.d.ts

@@ -0,0 +1,81 @@
+/**
+ * Session pinner — FR-006, FR-007, FR-008, FR-024.
+ *
+ * Pins a session to one model after the initial routing decision.
+ * Pin holds across subsequent turns until a qualified break event.
+ *
+ * Break rules (FR-008, exhaustive):
+ *   1. History compaction
+ *   2. Context overflow (estimated tokens exceed pinned model window)
+ *   3. Explicit operator/user override
+ *   4. Qualified loop escalation (threshold managed externally)
+ *   5. Cache-warmup economics when a cross-provider switch is proposed
+ *
+ * Sub-routing (FR-024): tool-result turns below the payload threshold
+ * may use an economical model on the same provider without breaking the pin.
+ */
+import type { ModelProfile, PinReason, RoutingRequest, SessionPin } from '../types/index.js';
+import type { StorePort } from '../types/store-port.js';
+import { type CacheEconomicsConfig } from './cache-economics.js';
+export type PinAction = 'use_pin' | 'sub_route' | 'break' | 'no_pin';
+export interface PinLookupResult {
+    readonly action: PinAction;
+    readonly pinnedModel?: ModelProfile;
+    readonly subRouteModel?: ModelProfile;
+    readonly breakReason?: PinReason;
+}
+export interface SessionPinnerConfig {
+    /** FR-024: max payload size (bytes or token estimate) for sub-routing. Default 2048. */
+    readonly toolResultSizeThreshold?: number;
+    /** Optional persistence — pins survive process restart when set. */
+    readonly store?: StorePort;
+    /** FR-008 rule #4: cache-warmup economics thresholds. */
+    readonly cacheEconomicsConfig?: CacheEconomicsConfig;
+    /**
+     * Break pin when estimated input tokens exceed the pinned model's
+     * max_input_tokens multiplied by this margin. Default 0.90.
+     */
+    readonly contextOverflowSafetyMargin?: number;
+}
+export declare class SessionPinner {
+    private readonly pins;
+    private readonly toolResultSizeThreshold;
+    private readonly store;
+    private readonly cacheEconomicsConfig;
+    private readonly contextOverflowSafetyMargin;
+    constructor(config?: SessionPinnerConfig);
+    /**
+     * Hydrate in-memory pin state for a session from persistent storage.
+     * Call on session start after a pi restart so lookupPin stays synchronous.
+     */
+    restoreSessionPin(sessionId: string): Promise<void>;
+    /**
+     * Synchronous pin lookup — must complete in <1ms.
+     * All data is in-memory (Map); no I/O.
+     */
+    lookupPin(request: RoutingRequest, fleet: readonly ModelProfile[]): PinLookupResult;
+    /**
+     * Create or update a session pin after a routing decision.
+     */
+    recordPin(sessionId: string, modelId: string, reason: PinReason): SessionPin;
+    /**
+     * Delete a session pin — used by loop escalation or external callers.
+     */
+    breakPin(sessionId: string): void;
+    /**
+     * Hydrate a pin from persistent storage (e.g. SQLite restore).
+     */
+    loadPin(pin: SessionPin): void;
+    /**
+     * Read-only access to the current pin (telemetry, inspection).
+     */
+    getPin(sessionId: string): SessionPin | null;
+    private evaluateBreakRules;
+    private evaluateContextOverflowBreak;
+    private evaluateCacheEconomicsBreak;
+    private handleForceOverride;
+    private persistPin;
+    private deletePersistedPin;
+    private evaluateSubRouting;
+}
+//# sourceMappingURL=session-pinner.d.ts.map

package/dist/domain/pinning/session-pinner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-pinner.d.ts","sourceRoot":"","sources":["../../../src/domain/pinning/session-pinner.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,KAAK,EACV,YAAY,EACZ,SAAS,EACT,cAAc,EACd,UAAU,EACX,MAAM,mBAAmB,CAAC;AAC3B,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AACxD,OAAO,EAEL,KAAK,oBAAoB,EAC1B,MAAM,sBAAsB,CAAC;AAI9B,MAAM,MAAM,SAAS,GAAG,SAAS,GAAG,WAAW,GAAG,OAAO,GAAG,QAAQ,CAAC;AAErE,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAC;IAC3B,QAAQ,CAAC,WAAW,CAAC,EAAE,YAAY,CAAC;IACpC,QAAQ,CAAC,aAAa,CAAC,EAAE,YAAY,CAAC;IACtC,QAAQ,CAAC,WAAW,CAAC,EAAE,SAAS,CAAC;CAClC;AAED,MAAM,WAAW,mBAAmB;IAClC,wFAAwF;IACxF,QAAQ,CAAC,uBAAuB,CAAC,EAAE,MAAM,CAAC;IAC1C,oEAAoE;IACpE,QAAQ,CAAC,KAAK,CAAC,EAAE,SAAS,CAAC;IAC3B,yDAAyD;IACzD,QAAQ,CAAC,oBAAoB,CAAC,EAAE,oBAAoB,CAAC;IACrD;;;OAGG;IACH,QAAQ,CAAC,2BAA2B,CAAC,EAAE,MAAM,CAAC;CAC/C;AASD,qBAAa,aAAa;IACxB,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAiC;IACtD,OAAO,CAAC,QAAQ,CAAC,uBAAuB,CAAS;IACjD,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAwB;IAC9C,OAAO,CAAC,QAAQ,CAAC,oBAAoB,CAAmC;IACxE,OAAO,CAAC,QAAQ,CAAC,2BAA2B,CAAS;gBAEzC,MAAM,CAAC,EAAE,mBAAmB;IASxC;;;OAGG;IACG,iBAAiB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAWzD;;;OAGG;IACH,SAAS,CACP,OAAO,EAAE,cAAc,EACvB,KAAK,EAAE,SAAS,YAAY,EAAE,GAC7B,eAAe;IAmClB;;OAEG;IACH,SAAS,CACP,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,SAAS,GAChB,UAAU;IAuBb;;OAEG;IACH,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IAKjC;;OAEG;IACH,OAAO,CAAC,GAAG,EAAE,UAAU,GAAG,IAAI;IAK9B;;OAEG;IACH,MAAM,CAAC,SAAS,EAAE,MAAM,GAAG,UAAU,GAAG,IAAI;IAM5C,OAAO,CAAC,kBAAkB;IA4C1B,OAAO,CAAC,4BAA4B;IAyBpC,OAAO,CAAC,2BAA2B;IA+CnC,OAAO,CAAC,mBAAmB;IAqB3B,OAAO,CAAC,UAAU;IAUlB,OAAO,CAAC,kBAAkB;IAY1B,OAAO,CAAC,kBAAkB;CAuC3B"}

package/dist/domain/pinning/session-pinner.js

@@ -0,0 +1,237 @@
+/**
+ * Session pinner — FR-006, FR-007, FR-008, FR-024.
+ *
+ * Pins a session to one model after the initial routing decision.
+ * Pin holds across subsequent turns until a qualified break event.
+ *
+ * Break rules (FR-008, exhaustive):
+ *   1. History compaction
+ *   2. Context overflow (estimated tokens exceed pinned model window)
+ *   3. Explicit operator/user override
+ *   4. Qualified loop escalation (threshold managed externally)
+ *   5. Cache-warmup economics when a cross-provider switch is proposed
+ *
+ * Sub-routing (FR-024): tool-result turns below the payload threshold
+ * may use an economical model on the same provider without breaking the pin.
+ */
+import { evaluateCacheEconomics, } from './cache-economics.js';
+// ─── Defaults ─────────────────────────────────────────────────────────────────
+const DEFAULT_TOOL_RESULT_SIZE_THRESHOLD = 2048;
+const DEFAULT_CONTEXT_OVERFLOW_SAFETY_MARGIN = 0.9;
+// ─── SessionPinner ────────────────────────────────────────────────────────────
+export class SessionPinner {
+    pins = new Map();
+    toolResultSizeThreshold;
+    store;
+    cacheEconomicsConfig;
+    contextOverflowSafetyMargin;
+    constructor(config) {
+        this.toolResultSizeThreshold =
+            config?.toolResultSizeThreshold ?? DEFAULT_TOOL_RESULT_SIZE_THRESHOLD;
+        this.store = config?.store;
+        this.cacheEconomicsConfig = config?.cacheEconomicsConfig;
+        this.contextOverflowSafetyMargin =
+            config?.contextOverflowSafetyMargin ?? DEFAULT_CONTEXT_OVERFLOW_SAFETY_MARGIN;
+    }
+    /**
+     * Hydrate in-memory pin state for a session from persistent storage.
+     * Call on session start after a pi restart so lookupPin stays synchronous.
+     */
+    async restoreSessionPin(sessionId) {
+        if (!this.store) {
+            return;
+        }
+        const pin = await this.store.getSessionPin(sessionId);
+        if (pin) {
+            this.pins.set(sessionId, pin);
+        }
+    }
+    /**
+     * Synchronous pin lookup — must complete in <1ms.
+     * All data is in-memory (Map); no I/O.
+     */
+    lookupPin(request, fleet) {
+        const pin = this.pins.get(request.session_id);
+        if (!pin) {
+            return { action: 'no_pin' };
+        }
+        // ── Break rule evaluation (FR-008) ──────────────────────────────────────
+        const breakResult = this.evaluateBreakRules(request, pin, fleet);
+        if (breakResult) {
+            return breakResult;
+        }
+        // ── Sub-routing (FR-024) ────────────────────────────────────────────────
+        const subRouteResult = this.evaluateSubRouting(request, pin, fleet);
+        if (subRouteResult) {
+            return subRouteResult;
+        }
+        // ── Default: use pinned model (FR-006, FR-007) ──────────────────────────
+        const pinnedModel = fleet.find((m) => m.id === pin.pinned_model_id && m.healthy !== false);
+        if (!pinnedModel) {
+            this.breakPin(request.session_id);
+            return { action: 'no_pin' };
+        }
+        return { action: 'use_pin', pinnedModel };
+    }
+    /**
+     * Create or update a session pin after a routing decision.
+     */
+    recordPin(sessionId, modelId, reason) {
+        const now = new Date().toISOString();
+        const existing = this.pins.get(sessionId);
+        const pin = {
+            session_id: sessionId,
+            pinned_model_id: modelId,
+            pin_reason: reason,
+            has_ever_switched: existing
+                ? existing.pinned_model_id !== modelId || existing.has_ever_switched
+                : false,
+            consecutive_upstream_errors: 0,
+            consecutive_tool_failures: existing?.consecutive_tool_failures ?? 0,
+            last_tool_failure_signature: existing?.last_tool_failure_signature ?? null,
+            created_at: existing?.created_at ?? now,
+            updated_at: now,
+        };
+        this.pins.set(sessionId, pin);
+        this.persistPin(pin);
+        return pin;
+    }
+    /**
+     * Delete a session pin — used by loop escalation or external callers.
+     */
+    breakPin(sessionId) {
+        this.pins.delete(sessionId);
+        this.deletePersistedPin(sessionId);
+    }
+    /**
+     * Hydrate a pin from persistent storage (e.g. SQLite restore).
+     */
+    loadPin(pin) {
+        this.pins.set(pin.session_id, pin);
+        this.persistPin(pin);
+    }
+    /**
+     * Read-only access to the current pin (telemetry, inspection).
+     */
+    getPin(sessionId) {
+        return this.pins.get(sessionId) ?? null;
+    }
+    // ─── Break rules (FR-008) ───────────────────────────────────────────────────
+    evaluateBreakRules(request, pin, fleet) {
+        // 1. History compaction → break pin, allow full re-route
+        if (request.compaction_flag) {
+            this.breakPin(request.session_id);
+            return { action: 'break', breakReason: 'compaction' };
+        }
+        // 2. Context overflow → break pin when input exceeds pinned model window
+        const overflowResult = this.evaluateContextOverflowBreak(request, pin, fleet);
+        if (overflowResult) {
+            return overflowResult;
+        }
+        // 3. Explicit operator / user override → pin to forced model
+        if (request.force_model_id) {
+            return this.handleForceOverride(request, pin, fleet);
+        }
+        // 4. Loop escalation — threshold tracking is on the pin record;
+        //    the loop_escalation pipeline stage calls breakPin() externally
+        //    when the threshold fires. No evaluation here beyond what the
+        //    pin record already reflects (consecutive_tool_failures).
+        // 5. Cache-warmup economics (FR-008 rule #4)
+        const cacheEconomicsResult = this.evaluateCacheEconomicsBreak(request, pin, fleet);
+        if (cacheEconomicsResult) {
+            return cacheEconomicsResult;
+        }
+        return null;
+    }
+    evaluateContextOverflowBreak(request, pin, fleet) {
+        const pinnedModel = fleet.find((m) => m.id === pin.pinned_model_id && m.healthy !== false);
+        const maxInputTokens = pinnedModel?.limits?.max_input_tokens;
+        if (!maxInputTokens) {
+            return null;
+        }
+        const tokenEstimate = request.estimated_input_tokens ?? request.prompt_text.length;
+        const effectiveLimit = maxInputTokens * this.contextOverflowSafetyMargin;
+        if (tokenEstimate > effectiveLimit) {
+            this.breakPin(request.session_id);
+            return { action: 'break', breakReason: 'context_overflow' };
+        }
+        return null;
+    }
+    evaluateCacheEconomicsBreak(request, pin, fleet) {
+        if (!request.candidate_model_id) {
+            return null;
+        }
+        if (request.candidate_model_id === pin.pinned_model_id) {
+            return null;
+        }
+        const pinnedModel = fleet.find((m) => m.id === pin.pinned_model_id && m.healthy !== false);
+        const candidate = fleet.find((m) => m.id === request.candidate_model_id && m.healthy !== false);
+        if (!pinnedModel || !candidate) {
+            return null;
+        }
+        if (pinnedModel.provider === candidate.provider) {
+            return null;
+        }
+        const tokenEstimate = request.estimated_input_tokens ?? request.prompt_text.length;
+        const econ = evaluateCacheEconomics(pin, pinnedModel, candidate, tokenEstimate, this.cacheEconomicsConfig);
+        if (econ.shouldSwitch) {
+            this.breakPin(request.session_id);
+            return { action: 'break', breakReason: 'cache_economics' };
+        }
+        return { action: 'use_pin', pinnedModel };
+    }
+    handleForceOverride(request, _pin, fleet) {
+        const forced = fleet.find((m) => m.id === request.force_model_id && m.healthy !== false);
+        if (forced) {
+            this.recordPin(request.session_id, forced.id, 'user_forced');
+            return { action: 'use_pin', pinnedModel: forced };
+        }
+        // Forced model unavailable — break pin, allow re-route
+        this.breakPin(request.session_id);
+        return { action: 'break', breakReason: 'user_forced' };
+    }
+    // ─── Persistence (StorePort) ────────────────────────────────────────────────
+    persistPin(pin) {
+        if (!this.store) {
+            return;
+        }
+        void this.store.putSessionPin(pin).catch((error) => {
+            console.warn('Failed to persist session pin', { sessionId: pin.session_id, error });
+        });
+    }
+    deletePersistedPin(sessionId) {
+        if (!this.store) {
+            return;
+        }
+        void this.store.deleteSessionPin(sessionId).catch((error) => {
+            console.warn('Failed to delete persisted session pin', { sessionId, error });
+        });
+    }
+    // ─── Sub-routing (FR-024) ───────────────────────────────────────────────────
+    evaluateSubRouting(request, pin, fleet) {
+        if (request.turn_type !== 'tool_result') {
+            return null;
+        }
+        const payloadSize = request.estimated_input_tokens ?? request.prompt_text.length;
+        if (payloadSize > this.toolResultSizeThreshold) {
+            return null;
+        }
+        const pinnedModel = fleet.find((m) => m.id === pin.pinned_model_id);
+        if (!pinnedModel) {
+            return null;
+        }
+        const econModel = fleet.find((m) => m.tier === 'economical-cloud' &&
+            m.provider === pinnedModel.provider &&
+            m.id !== pin.pinned_model_id &&
+            m.healthy !== false);
+        if (!econModel) {
+            return null;
+        }
+        return {
+            action: 'sub_route',
+            subRouteModel: econModel,
+            pinnedModel,
+        };
+    }
+}
+//# sourceMappingURL=session-pinner.js.map

package/dist/domain/pinning/session-pinner.js.map

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

package/dist/domain/pinning/sub-route-policy.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Sub-route policy — FR-024.
+ *
+ * Pure policy function that evaluates whether a tool-result turn is
+ * eligible for same-provider economical sub-routing without breaking
+ * the session pin.
+ *
+ * Rules (FR-024, exhaustive):
+ *   1. Turn must be a tool_result.
+ *   2. Payload must be below the configurable size threshold (default 2 KB).
+ *   3. An economical-cloud model on the same provider as the pin must exist
+ *      and be healthy.
+ *   4. The economical model must not be the pinned model itself.
+ *
+ * When all conditions are met the caller may dispatch to the economical
+ * model. The session pin record is unchanged — the pin holds.
+ */
+import type { ModelProfile, RoutingRequest, SessionPin } from '../types/index.js';
+export type SubRouteReason = 'eligible' | 'not_tool_result' | 'payload_exceeds_threshold' | 'pinned_model_not_in_fleet' | 'no_same_provider_economical';
+export interface SubRouteEvaluation {
+    readonly eligible: boolean;
+    readonly subRouteModel?: ModelProfile;
+    readonly pinnedModel?: ModelProfile;
+    readonly reason: SubRouteReason;
+}
+export interface SubRoutePolicyConfig {
+    /** Max payload size (bytes or token estimate) for sub-routing. Default 2048. */
+    readonly sizeThreshold?: number;
+}
+/**
+ * Select the lowest-cost healthy model from candidates (SP-085).
+ */
+export declare function selectLowestCostModel(candidates: readonly ModelProfile[]): ModelProfile | undefined;
+/**
+ * Evaluate sub-route eligibility for a single request against a session pin.
+ *
+ * Designed for the hot path — no allocation beyond the return object,
+ * no I/O, deterministic.
+ */
+export declare function evaluateSubRoutePolicy(request: RoutingRequest, pin: SessionPin, fleet: readonly ModelProfile[], config?: SubRoutePolicyConfig): SubRouteEvaluation;
+//# sourceMappingURL=sub-route-policy.d.ts.map

package/dist/domain/pinning/sub-route-policy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sub-route-policy.d.ts","sourceRoot":"","sources":["../../../src/domain/pinning/sub-route-policy.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAIlF,MAAM,MAAM,cAAc,GACtB,UAAU,GACV,iBAAiB,GACjB,2BAA2B,GAC3B,2BAA2B,GAC3B,6BAA6B,CAAC;AAElC,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,aAAa,CAAC,EAAE,YAAY,CAAC;IACtC,QAAQ,CAAC,WAAW,CAAC,EAAE,YAAY,CAAC;IACpC,QAAQ,CAAC,MAAM,EAAE,cAAc,CAAC;CACjC;AAED,MAAM,WAAW,oBAAoB;IACnC,gFAAgF;IAChF,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;CACjC;AAMD;;GAEG;AACH,wBAAgB,qBAAqB,CACnC,UAAU,EAAE,SAAS,YAAY,EAAE,GAClC,YAAY,GAAG,SAAS,CAc1B;AAID;;;;;GAKG;AACH,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,cAAc,EACvB,GAAG,EAAE,UAAU,EACf,KAAK,EAAE,SAAS,YAAY,EAAE,EAC9B,MAAM,CAAC,EAAE,oBAAoB,GAC5B,kBAAkB,CAuCpB"}

package/dist/domain/pinning/sub-route-policy.js

@@ -0,0 +1,72 @@
+/**
+ * Sub-route policy — FR-024.
+ *
+ * Pure policy function that evaluates whether a tool-result turn is
+ * eligible for same-provider economical sub-routing without breaking
+ * the session pin.
+ *
+ * Rules (FR-024, exhaustive):
+ *   1. Turn must be a tool_result.
+ *   2. Payload must be below the configurable size threshold (default 2 KB).
+ *   3. An economical-cloud model on the same provider as the pin must exist
+ *      and be healthy.
+ *   4. The economical model must not be the pinned model itself.
+ *
+ * When all conditions are met the caller may dispatch to the economical
+ * model. The session pin record is unchanged — the pin holds.
+ */
+// ─── Defaults ─────────────────────────────────────────────────────────────────
+const DEFAULT_SIZE_THRESHOLD = 2048;
+/**
+ * Select the lowest-cost healthy model from candidates (SP-085).
+ */
+export function selectLowestCostModel(candidates) {
+    let best;
+    let bestCost = Infinity;
+    for (const model of candidates) {
+        if (model.healthy === false)
+            continue;
+        const cost = model.pricing.fallback_cost_per_1m;
+        if (cost < bestCost) {
+            bestCost = cost;
+            best = model;
+        }
+    }
+    return best;
+}
+// ─── Policy ───────────────────────────────────────────────────────────────────
+/**
+ * Evaluate sub-route eligibility for a single request against a session pin.
+ *
+ * Designed for the hot path — no allocation beyond the return object,
+ * no I/O, deterministic.
+ */
+export function evaluateSubRoutePolicy(request, pin, fleet, config) {
+    const threshold = config?.sizeThreshold ?? DEFAULT_SIZE_THRESHOLD;
+    if (request.turn_type !== 'tool_result') {
+        return { eligible: false, reason: 'not_tool_result' };
+    }
+    const payloadSize = request.estimated_input_tokens ?? request.prompt_text.length;
+    if (payloadSize > threshold) {
+        return { eligible: false, reason: 'payload_exceeds_threshold' };
+    }
+    const pinnedModel = fleet.find((m) => m.id === pin.pinned_model_id);
+    if (!pinnedModel) {
+        return { eligible: false, reason: 'pinned_model_not_in_fleet' };
+    }
+    const candidates = fleet.filter((m) => m.tier === 'economical-cloud' &&
+        m.provider === pinnedModel.provider &&
+        m.id !== pin.pinned_model_id &&
+        m.healthy !== false);
+    const econModel = selectLowestCostModel(candidates);
+    if (!econModel) {
+        return { eligible: false, reason: 'no_same_provider_economical' };
+    }
+    return {
+        eligible: true,
+        subRouteModel: econModel,
+        pinnedModel,
+        reason: 'eligible',
+    };
+}
+//# sourceMappingURL=sub-route-policy.js.map

package/dist/domain/pinning/sub-route-policy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sub-route-policy.js","sourceRoot":"","sources":["../../../src/domain/pinning/sub-route-policy.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAyBH,iFAAiF;AAEjF,MAAM,sBAAsB,GAAG,IAAI,CAAC;AAEpC;;GAEG;AACH,MAAM,UAAU,qBAAqB,CACnC,UAAmC;IAEnC,IAAI,IAA8B,CAAC;IACnC,IAAI,QAAQ,GAAG,QAAQ,CAAC;IAExB,KAAK,MAAM,KAAK,IAAI,UAAU,EAAE,CAAC;QAC/B,IAAI,KAAK,CAAC,OAAO,KAAK,KAAK;YAAE,SAAS;QACtC,MAAM,IAAI,GAAG,KAAK,CAAC,OAAO,CAAC,oBAAoB,CAAC;QAChD,IAAI,IAAI,GAAG,QAAQ,EAAE,CAAC;YACpB,QAAQ,GAAG,IAAI,CAAC;YAChB,IAAI,GAAG,KAAK,CAAC;QACf,CAAC;IACH,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAED,iFAAiF;AAEjF;;;;;GAKG;AACH,MAAM,UAAU,sBAAsB,CACpC,OAAuB,EACvB,GAAe,EACf,KAA8B,EAC9B,MAA6B;IAE7B,MAAM,SAAS,GAAG,MAAM,EAAE,aAAa,IAAI,sBAAsB,CAAC;IAElE,IAAI,OAAO,CAAC,SAAS,KAAK,aAAa,EAAE,CAAC;QACxC,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,EAAE,iBAAiB,EAAE,CAAC;IACxD,CAAC;IAED,MAAM,WAAW,GACf,OAAO,CAAC,sBAAsB,IAAI,OAAO,CAAC,WAAW,CAAC,MAAM,CAAC;IAE/D,IAAI,WAAW,GAAG,SAAS,EAAE,CAAC;QAC5B,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,EAAE,2BAA2B,EAAE,CAAC;IAClE,CAAC;IAED,MAAM,WAAW,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,GAAG,CAAC,eAAe,CAAC,CAAC;IACpE,IAAI,CAAC,WAAW,EAAE,CAAC;QACjB,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,EAAE,2BAA2B,EAAE,CAAC;IAClE,CAAC;IAED,MAAM,UAAU,GAAG,KAAK,CAAC,MAAM,CAC7B,CAAC,CAAC,EAAE,EAAE,CACJ,CAAC,CAAC,IAAI,KAAK,kBAAkB;QAC7B,CAAC,CAAC,QAAQ,KAAK,WAAW,CAAC,QAAQ;QACnC,CAAC,CAAC,EAAE,KAAK,GAAG,CAAC,eAAe;QAC5B,CAAC,CAAC,OAAO,KAAK,KAAK,CACtB,CAAC;IAEF,MAAM,SAAS,GAAG,qBAAqB,CAAC,UAAU,CAAC,CAAC;IAEpD,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,EAAE,6BAA6B,EAAE,CAAC;IACpE,CAAC;IAED,OAAO;QACL,QAAQ,EAAE,IAAI;QACd,aAAa,EAAE,SAAS;QACxB,WAAW;QACX,MAAM,EAAE,UAAU;KACnB,CAAC;AACJ,CAAC"}

package/dist/domain/pipeline/router-pipeline.d.ts

@@ -0,0 +1,180 @@
+/**
+ * Pipeline stage orchestrator — FR-001, FR-006, FR-022.
+ *
+ * Runs stages sequentially with early-exit on decision.
+ * Documented order (SP-119, #69):
+ *   hardware_probe → loop_escalation → turn_envelope → context_fit → low_intensity
+ *   → session_pin → triage → local_zero → triage_cloud_fallback → hydra_match
+ *   → safe_default → context_overflow_fallback
+ * Any stage failure falls back to safeCloudDefault(); never throws to host.
+ */
+import type { ModelProfile, PriceCatalog, RoutingDecision, RoutingRequest, Tier } from '../types/index.js';
+import type { LowIntensityConfig } from '../types/schemas.js';
+import type { HardwareProbeConfig, SystemInfo } from '../../infrastructure/hardware/hardware-probe.js';
+import type { HttpFetchPort, LocalZeroTierConfig } from '../../infrastructure/local/local-zero-tier.js';
+import type { TriageVerdict } from '../triage/triage-engine.js';
+import { type ContextFitConfig } from '../routing/context-fit.js';
+import type { SessionPinner } from '../pinning/session-pinner.js';
+import type { LoopEscalationConfig } from '../pinning/loop-escalation.js';
+import { RoutingTelemetryEmitter } from '../../infrastructure/telemetry/routing-telemetry.js';
+import type { HydraMatcher as HydraMatcherType } from '../matching/hydra-matcher.js';
+import type { ClusterMatcher, ClusterMatchResult } from '../matching/cluster-matcher.js';
+import { type PSuccessWeights } from '../routing/p-success-classifier.js';
+export interface StageResult {
+    readonly decided: boolean;
+    readonly decision?: RoutingDecision;
+    readonly stage: string;
+}
+export type PipelineStage = (request: RoutingRequest) => Promise<StageResult>;
+/** Canonical pipeline stage order — keep README/specs in sync (SP-119). */
+export declare const PIPELINE_STAGE_ORDER: readonly ["hardware_probe", "loop_escalation", "turn_envelope", "context_fit", "low_intensity", "session_pin", "triage", "local_zero", "triage_cloud_fallback", "hydra_match", "safe_default", "context_overflow_fallback"];
+export type PipelineStageName = (typeof PIPELINE_STAGE_ORDER)[number];
+/** Inputs for local_zero eligibility beyond trivial-only triage (SP-111, #59). */
+export interface LocalEligibleInput {
+    readonly triageVerdict: TriageVerdict | null;
+    readonly tierHint: Tier | null;
+    readonly lowIntensityScore: number | null;
+    readonly highThreshold: number;
+    readonly clusterMatch: ClusterMatchResult | null;
+}
+export interface LocalEligibleResult {
+    readonly eligible: boolean;
+    readonly reason: string | null;
+}
+/**
+ * Disjunction: triage trivial OR low-intensity zero-tier hint (high confidence)
+ * OR high-confidence zero-tier cluster match.
+ */
+export declare function resolveLocalEligible(input: LocalEligibleInput): LocalEligibleResult;
+export interface PipelineOptions {
+    readonly hardwareConfig?: HardwareProbeConfig;
+    readonly localConfig?: LocalZeroTierConfig;
+    readonly systemInfoProvider?: () => Promise<SystemInfo>;
+    readonly httpFetchPort?: HttpFetchPort;
+    readonly sessionPinner?: SessionPinner;
+    readonly loopEscalationConfig?: LoopEscalationConfig;
+    readonly telemetryEmitter?: RoutingTelemetryEmitter;
+    readonly hydraMatcher?: HydraMatcherType;
+    readonly clusterMatcher?: ClusterMatcher;
+    readonly lowIntensityConfig?: LowIntensityConfig;
+    readonly priceCatalog?: PriceCatalog | null;
+    readonly contextFitConfig?: ContextFitConfig;
+    /** Preloaded P(success) weights for tests; lazy-loads artifact when omitted (SP-105). */
+    readonly pSuccessWeights?: PSuccessWeights;
+    readonly pSuccessWeightsPath?: string;
+}
+export declare class RouterPipeline {
+    private readonly stages;
+    private readonly fleet;
+    private readonly options;
+    /** Per-route transient fleet — defaults to constructor fleet. */
+    private activeFleet;
+    /** Unfiltered fleet for overflow escalation (SP-095). */
+    private fullFleet;
+    /** Per-route transient state — reset on each route() call. */
+    private currentHardwareResult;
+    private currentTriageResult;
+    private currentHydraResult;
+    private currentClusterMatch;
+    private currentTierHint;
+    private currentTierHintReasonCode;
+    private currentLowIntensityScore;
+    private currentPSuccessCheap;
+    private currentPSuccessAlpha;
+    private currentExpectedCostByTier;
+    private currentLocalEligibleReason;
+    private pSuccessWeightsLoaded;
+    private cachedPSuccessWeights;
+    private currentContextFitRejected;
+    private currentContextFitViableCount;
+    private contextOverflowPreferredProvider;
+    private contextOverflowTriggered;
+    constructor(fleet: readonly ModelProfile[], options?: PipelineOptions);
+    route(request: RoutingRequest, fleetOverride?: readonly ModelProfile[]): Promise<RoutingDecision>;
+    /**
+     * SP-080: move Google/Gemini profiles to the end of the fleet when prior tool
+     * calls exist so tier `.find()` passes prefer non-Gemini models first.
+     * Honors `force_model_id` by leaving fleet order unchanged.
+     */
+    private prioritizeFleetForToolHistory;
+    /** Attach privacy-safe dataset features captured during pipeline stages (SP-057, SP-119). */
+    private attachFeatures;
+    private mergeFeatureCandidates;
+    private resolveFailedStage;
+    private logPipelineError;
+    private redactPromptFromError;
+    private emitPipelineErrorTelemetry;
+    /** Step 7: emit routing telemetry after decision (T040). */
+    private emitTelemetry;
+    private withEstimatedCost;
+    private buildFallbackDecision;
+    private shouldAttemptContextOverflowFallback;
+    private buildContextOverflowFallbackDecision;
+    /**
+     * SP-095: after safe_default, escalate to largest-fit model when economical
+     * models cannot fit the current context.
+     */
+    private contextOverflowFallback;
+    /**
+     * SP-022: economical-cloud default when no earlier stage decides.
+     * Defers to context_overflow_fallback when economical models were context-rejected.
+     */
+    private safeDefaultStage;
+    private markContextOverflowFromPin;
+    private hardwareProbeStage;
+    /**
+     * SP-093: filter fleet to models whose context window fits estimated input
+     * tokens before session pin and HyDRA matching.
+     */
+    private contextFitStage;
+    /**
+     * SC-007: classification_only MUST NOT dispatch full local.
+     * Eligibility: triage trivial OR low-intensity zero-tier hint OR zero-tier cluster (SP-111).
+     */
+    private localZeroTierStage;
+    private triage;
+    /**
+     * Economical-cloud fallback for trivial prompts after local zero-tier is skipped
+     * or unavailable (PRD Step 4 cloud fallback).
+     */
+    private triageCloudFallback;
+    private sessionPin;
+    /**
+     * After a routing decision, persist an initial pin when none exists.
+     * Sub-routes and already-pinned decisions skip persistence.
+     */
+    private persistPinIfNeeded;
+    private static readonly TURN_TIER_MAP;
+    private turnEnvelope;
+    /**
+     * Runs after turn_envelope and context_fit, before session_pin. Computes low-intensity score
+     * from structural signals and optional cluster match; sets tier_hint and constrains
+     * the active fleet for subsequent HyDRA matching when confidence is high.
+     */
+    private lowIntensityGate;
+    private selectExpectedCostTierHint;
+    private logExpectedCostExplain;
+    private resolvePSuccessWeights;
+    private resolveTierHint;
+    private resolveLowIntensityTierHint;
+    private isLocalZeroTierReady;
+    private resolveLowIntensityReasonCode;
+    private resolveHighIntensityReasonCode;
+    private constrainFleetToTierHint;
+    /**
+     * Observational loop escalation: detects repeated identical tool failures
+     * and re-pins the session to a frontier-capable tier.
+     *
+     * Runs before turn_envelope and session_pin so it can modify pin state.
+     * Never returns decided: true — turnEnvelope or sessionPin picks up the
+     * (potentially escalated) pin on subsequent stages.
+     */
+    private loopEscalation;
+    /**
+     * Step 5: HyDRA embedding matcher for ambiguous prompts (T050).
+     * Scores fleet candidates via embedding cosine similarity with shortfall gate.
+     * Pass-through when no matcher is configured.
+     */
+    private hydraMatcher;
+}
+//# sourceMappingURL=router-pipeline.d.ts.map

package/dist/domain/pipeline/router-pipeline.d.ts.map

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