pi-smart-router 0.1.0

package/dist/infrastructure/gateway/gateway-dispatch.js

@@ -0,0 +1,308 @@
+/**
+ * Gateway dispatch — T020, T055, T056, FR-001, FR-017, FR-018, FR-022, FR-023.
+ *
+ * Infrastructure entry point that delegates routing to the domain pipeline.
+ * Integrates circuit breaker for resilient failover (FR-018: infra errors only),
+ * weighted distribution across same-tier model endpoints (T056), and
+ * per-key rate limiting with 429 + Retry-After responses (T057, FR-017).
+ *
+ * FR-023: preserves provider context-caching semantics on same-provider
+ * request paths by tracking the last-used provider per session.
+ *
+ * SP-097: Cursor subscription quota exhaustion detection and failover to
+ * `cursor/auto` or economical API models with `cursor_quota_exhausted` telemetry.
+ */
+import { RouterPipeline } from '../../domain/pipeline/router-pipeline.js';
+import { CircuitBreaker, isInfraError } from './circuit-breaker.js';
+const CURSOR_QUOTA_MESSAGE_PATTERNS = [
+    /usage\s+limit/i,
+    /hit your usage/i,
+    /quota\s+exhaust/i,
+    /subscription.*limit/i,
+    /switch to auto/i,
+];
+const CURSOR_QUOTA_ERROR_CODES = new Set([
+    'usage_limit_exceeded',
+    'resource_exhausted',
+    'quota_exceeded',
+    'insufficient_quota',
+]);
+/**
+ * Classify Cursor subscription quota / usage-limit errors from dogfood evidence
+ * (#70: "You've hit your usage limit… Switch to Auto for more usage…").
+ */
+export function isCursorQuotaExhaustedError(error) {
+    const code = error.code?.trim().toLowerCase();
+    if (code && CURSOR_QUOTA_ERROR_CODES.has(code)) {
+        return true;
+    }
+    const message = error.message ?? '';
+    if (message.length > 0 && CURSOR_QUOTA_MESSAGE_PATTERNS.some((pattern) => pattern.test(message))) {
+        return true;
+    }
+    if (error.statusCode === 429 && /usage|quota|limit/i.test(message)) {
+        return true;
+    }
+    return false;
+}
+/** Cursor frontier models billed against subscription quota (composer-*, cursor/*). */
+export function isCursorSubscriptionModel(model) {
+    const provider = model.provider.trim().toLowerCase();
+    if (provider === 'cursor') {
+        return true;
+    }
+    const id = model.id.trim().toLowerCase();
+    return id.startsWith('composer-') || id.startsWith('cursor/');
+}
+/** Cursor opaque-auto models (`cursor/auto`, `cursor/*`). */
+export function isCursorAutoModel(model) {
+    const id = model.id.trim().toLowerCase();
+    return id === 'cursor/auto' || id === 'auto' || id.startsWith('cursor/');
+}
+/**
+ * Whether a provider error should trigger model failover (infra or Cursor quota).
+ * Quota exhaustion on Cursor subscription models must not trip the circuit breaker.
+ */
+export function shouldFailoverOnProviderError(error, failedModel) {
+    if (isCursorQuotaExhaustedError(error)) {
+        return true;
+    }
+    if (failedModel && isCursorSubscriptionModel(failedModel) && error.statusCode === 429) {
+        return true;
+    }
+    return isInfraError(error);
+}
+// ─── Weighted model selection (T056) ─────────────────────────────────────────
+/**
+ * Select a model from same-tier candidates using inverse-cost weighting.
+ * Models with lower cost get proportionally more traffic. Falls back to
+ * uniform random when all costs are equal.
+ */
+export function weightedSelect(candidates) {
+    if (candidates.length === 0)
+        return undefined;
+    if (candidates.length === 1)
+        return candidates[0];
+    const costs = candidates.map((c) => c.pricing.fallback_cost_per_1m);
+    const maxCost = Math.max(...costs);
+    if (maxCost === 0) {
+        return candidates[Math.floor(Math.random() * candidates.length)];
+    }
+    const weights = costs.map((c) => (maxCost + 1) / (c + 1));
+    const totalWeight = weights.reduce((sum, w) => sum + w, 0);
+    let random = Math.random() * totalWeight;
+    for (let i = 0; i < candidates.length; i++) {
+        random -= weights[i];
+        if (random <= 0)
+            return candidates[i];
+    }
+    return candidates[candidates.length - 1];
+}
+export class GatewayDispatch {
+    pipeline;
+    fleet;
+    cacheMarkers = new Map();
+    circuitBreaker;
+    rateLimiter;
+    quotaExhaustedModels = new Set();
+    constructor(fleet, options) {
+        this.fleet = fleet;
+        this.pipeline = new RouterPipeline(fleet, options);
+        this.circuitBreaker = new CircuitBreaker(options?.circuitBreakerConfig);
+        this.rateLimiter = options?.rateLimiter;
+    }
+    /**
+     * Route a single request through the pipeline.
+     *
+     * 1. Run pipeline to get routing decision.
+     * 2. Verify circuit breaker allows dispatch to the selected model.
+     * 3. If the selected model's circuit is open, attempt failover to a
+     *    same-tier alternative (T056).
+     * 4. Update FR-023 cache marker.
+     *
+     * Never throws.
+     */
+    async dispatch(request, options) {
+        const effectiveFleet = options?.effectiveFleet ?? this.fleet;
+        const decision = await this.pipeline.route(request, effectiveFleet);
+        const finalDecision = this.applyCircuitBreaker(decision, effectiveFleet);
+        this.updateCacheMarker(request.session_id, finalDecision);
+        return finalDecision;
+    }
+    /**
+     * Route with per-key rate limiting (T057, FR-017).
+     *
+     * Checks the token bucket before routing. Returns a RateLimitResult with
+     * 429-compatible body `{ error, retry_after_seconds }` when the bucket is
+     * exhausted. Otherwise delegates to dispatch().
+     */
+    async dispatchWithRateLimit(request, rateLimitKey) {
+        if (this.rateLimiter) {
+            const bucket = this.rateLimiter.consumeToken(rateLimitKey);
+            if (!bucket.allowed) {
+                return {
+                    limited: true,
+                    error: 'rate_limit_exceeded',
+                    retry_after_seconds: bucket.retryAfterSeconds ?? 0,
+                };
+            }
+        }
+        return this.dispatch(request);
+    }
+    /**
+     * Record an upstream response outcome for circuit breaker tracking.
+     * Only infra errors trip the breaker; policy/safety rejections are ignored (FR-018).
+     * Cursor quota exhaustion is tracked for SP-097 failover without opening circuits.
+     */
+    recordOutcome(modelId, error) {
+        if (!error) {
+            this.circuitBreaker.recordSuccess(modelId);
+            return;
+        }
+        if (isCursorQuotaExhaustedError(error)) {
+            this.quotaExhaustedModels.add(modelId);
+            return;
+        }
+        const failedModel = this.fleet.find((m) => m.id === modelId);
+        if (failedModel && isCursorSubscriptionModel(failedModel) && error.statusCode === 429) {
+            this.quotaExhaustedModels.add(modelId);
+            return;
+        }
+        if (isInfraError(error)) {
+            this.circuitBreaker.recordFailure(modelId);
+        }
+    }
+    /** Expose circuit breaker for observability and testing. */
+    getCircuitBreaker() {
+        return this.circuitBreaker;
+    }
+    /** Whether a model recently returned a Cursor quota exhaustion error (SP-097). */
+    hasQuotaExhaustion(modelId) {
+        return this.quotaExhaustedModels.has(modelId);
+    }
+    /**
+     * Retrieve the current cache marker for a session (FR-023 inspection).
+     */
+    getCacheMarker(sessionId) {
+        return this.cacheMarkers.get(sessionId) ?? null;
+    }
+    /**
+     * Select an alternate model when the current target is unavailable or failed.
+     * Prefers same-tier healthy models with closed circuits, then any tier.
+     * When the failed model hit Cursor quota limits, prefers `cursor/auto` then
+     * economical API models with `cursor_quota_exhausted`.
+     */
+    selectFailover(decision, excludeModelIds = [], fleetOverride) {
+        const excluded = new Set(excludeModelIds);
+        const fleet = fleetOverride ?? this.fleet;
+        const quotaFailover = this.selectCursorQuotaFailover(decision, excluded, fleet);
+        if (quotaFailover) {
+            return quotaFailover;
+        }
+        const sameTier = fleet.filter((m) => m.tier === decision.tier &&
+            m.id !== decision.selected_model_id &&
+            !excluded.has(m.id) &&
+            m.healthy !== false &&
+            this.circuitBreaker.canDispatch(m.id));
+        const sameTierAlternative = weightedSelect(sameTier);
+        if (sameTierAlternative) {
+            return {
+                ...decision,
+                selected_model_id: sameTierAlternative.id,
+                reason_code: 'circuit_breaker_failover',
+            };
+        }
+        const anyHealthy = fleet.filter((m) => m.id !== decision.selected_model_id &&
+            !excluded.has(m.id) &&
+            m.healthy !== false &&
+            this.circuitBreaker.canDispatch(m.id));
+        const fallback = weightedSelect(anyHealthy);
+        if (fallback) {
+            return {
+                ...decision,
+                selected_model_id: fallback.id,
+                tier: fallback.tier,
+                reason_code: 'circuit_breaker_failover',
+            };
+        }
+        return undefined;
+    }
+    /**
+     * If the selected model's circuit is open, attempt to fail over to
+     * an alternative model on the same tier (T056 weighted distribution).
+     * Falls back to any healthy model on any tier if no same-tier alternative exists.
+     */
+    applyCircuitBreaker(decision, fleet = this.fleet) {
+        if (this.circuitBreaker.canDispatch(decision.selected_model_id)) {
+            return decision;
+        }
+        return this.selectFailover(decision, [], fleet) ?? decision;
+    }
+    /**
+     * SP-097: fail over from quota-exhausted Cursor models to `cursor/auto` or
+     * the cheapest viable economical API model in the scoped fleet.
+     */
+    selectCursorQuotaFailover(decision, excluded, fleet) {
+        const failedIds = [decision.selected_model_id, ...excluded];
+        const quotaFailed = failedIds.some((id) => this.quotaExhaustedModels.has(id));
+        if (!quotaFailed) {
+            return undefined;
+        }
+        const failedModel = fleet.find((m) => m.id === decision.selected_model_id);
+        if (failedModel && !isCursorSubscriptionModel(failedModel)) {
+            return undefined;
+        }
+        const cursorAuto = fleet.find((m) => isCursorAutoModel(m) &&
+            !excluded.has(m.id) &&
+            m.id !== decision.selected_model_id &&
+            m.healthy !== false &&
+            this.circuitBreaker.canDispatch(m.id));
+        if (cursorAuto) {
+            return {
+                ...decision,
+                selected_model_id: cursorAuto.id,
+                tier: cursorAuto.tier,
+                reason_code: 'cursor_quota_exhausted',
+            };
+        }
+        const economical = fleet.filter((m) => m.tier === 'economical-cloud' &&
+            !excluded.has(m.id) &&
+            m.id !== decision.selected_model_id &&
+            m.healthy !== false &&
+            !isCursorSubscriptionModel(m) &&
+            this.circuitBreaker.canDispatch(m.id));
+        const economicalFallback = weightedSelect(economical);
+        if (economicalFallback) {
+            return {
+                ...decision,
+                selected_model_id: economicalFallback.id,
+                tier: economicalFallback.tier,
+                reason_code: 'cursor_quota_exhausted',
+            };
+        }
+        return undefined;
+    }
+    /**
+     * FR-023: track the provider and cache-friendly status for the session.
+     * Sub-routed requests on the same provider preserve the existing marker
+     * rather than replacing it — the pin model's cache state is authoritative.
+     */
+    updateCacheMarker(sessionId, decision) {
+        const model = this.fleet.find((m) => m.id === decision.selected_model_id);
+        if (!model)
+            return;
+        const existing = this.cacheMarkers.get(sessionId);
+        if (existing &&
+            existing.provider === model.provider &&
+            decision.reason_code === 'tool_result_sub_route') {
+            return;
+        }
+        this.cacheMarkers.set(sessionId, {
+            sessionId,
+            provider: model.provider,
+            modelId: model.id,
+            cacheFriendly: model.performance?.cache_friendly ?? false,
+        });
+    }
+}
+//# sourceMappingURL=gateway-dispatch.js.map

package/dist/infrastructure/gateway/gateway-dispatch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"gateway-dispatch.js","sourceRoot":"","sources":["../../../src/infrastructure/gateway/gateway-dispatch.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAOH,OAAO,EAAE,cAAc,EAAE,MAAM,0CAA0C,CAAC;AAE1E,OAAO,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAkCpE,MAAM,6BAA6B,GAAsB;IACvD,gBAAgB;IAChB,iBAAiB;IACjB,kBAAkB;IAClB,sBAAsB;IACtB,iBAAiB;CAClB,CAAC;AAEF,MAAM,wBAAwB,GAAG,IAAI,GAAG,CAAC;IACvC,sBAAsB;IACtB,oBAAoB;IACpB,gBAAgB;IAChB,oBAAoB;CACrB,CAAC,CAAC;AAEH;;;GAGG;AACH,MAAM,UAAU,2BAA2B,CAAC,KAAyB;IACnE,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAC9C,IAAI,IAAI,IAAI,wBAAwB,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;QAC/C,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,IAAI,EAAE,CAAC;IACpC,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,IAAI,6BAA6B,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,EAAE,CAAC;QACjG,OAAO,IAAI,CAAC;IACd,CAAC;IAED,IAAI,KAAK,CAAC,UAAU,KAAK,GAAG,IAAI,oBAAoB,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;QACnE,OAAO,IAAI,CAAC;IACd,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC;AAED,uFAAuF;AACvF,MAAM,UAAU,yBAAyB,CAAC,KAAmB;IAC3D,MAAM,QAAQ,GAAG,KAAK,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IACrD,IAAI,QAAQ,KAAK,QAAQ,EAAE,CAAC;QAC1B,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,EAAE,GAAG,KAAK,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IACzC,OAAO,EAAE,CAAC,UAAU,CAAC,WAAW,CAAC,IAAI,EAAE,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC;AAChE,CAAC;AAED,6DAA6D;AAC7D,MAAM,UAAU,iBAAiB,CAAC,KAAmB;IACnD,MAAM,EAAE,GAAG,KAAK,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IACzC,OAAO,EAAE,KAAK,aAAa,IAAI,EAAE,KAAK,MAAM,IAAI,EAAE,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC;AAC3E,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,6BAA6B,CAC3C,KAAyB,EACzB,WAA0B;IAE1B,IAAI,2BAA2B,CAAC,KAAK,CAAC,EAAE,CAAC;QACvC,OAAO,IAAI,CAAC;IACd,CAAC;IAED,IAAI,WAAW,IAAI,yBAAyB,CAAC,WAAW,CAAC,IAAI,KAAK,CAAC,UAAU,KAAK,GAAG,EAAE,CAAC;QACtF,OAAO,IAAI,CAAC;IACd,CAAC;IAED,OAAO,YAAY,CAAC,KAAK,CAAC,CAAC;AAC7B,CAAC;AAaD,gFAAgF;AAEhF;;;;GAIG;AACH,MAAM,UAAU,cAAc,CAC5B,UAAmC;IAEnC,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,SAAS,CAAC;IAC9C,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,UAAU,CAAC,CAAC,CAAC,CAAC;IAElD,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,oBAAoB,CAAC,CAAC;IACpE,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC,CAAC;IAEnC,IAAI,OAAO,KAAK,CAAC,EAAE,CAAC;QAClB,OAAO,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC;IACnE,CAAC;IAED,MAAM,OAAO,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,OAAO,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;IAC1D,MAAM,WAAW,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC;IAE3D,IAAI,MAAM,GAAG,IAAI,CAAC,MAAM,EAAE,GAAG,WAAW,CAAC;IACzC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,UAAU,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QAC3C,MAAM,IAAI,OAAO,CAAC,CAAC,CAAE,CAAC;QACtB,IAAI,MAAM,IAAI,CAAC;YAAE,OAAO,UAAU,CAAC,CAAC,CAAC,CAAC;IACxC,CAAC;IAED,OAAO,UAAU,CAAC,UAAU,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;AAC3C,CAAC;AAED,MAAM,OAAO,eAAe;IACT,QAAQ,CAAiB;IACzB,KAAK,CAA0B;IAC/B,YAAY,GAAG,IAAI,GAAG,EAAuB,CAAC;IAC9C,cAAc,CAAiB;IAC/B,WAAW,CAA4B;IACvC,oBAAoB,GAAG,IAAI,GAAG,EAAU,CAAC;IAE1D,YAAY,KAA8B,EAAE,OAAgC;QAC1E,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;QACnB,IAAI,CAAC,QAAQ,GAAG,IAAI,cAAc,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;QACnD,IAAI,CAAC,cAAc,GAAG,IAAI,cAAc,CAAC,OAAO,EAAE,oBAAoB,CAAC,CAAC;QACxE,IAAI,CAAC,WAAW,GAAG,OAAO,EAAE,WAAW,CAAC;IAC1C,CAAC;IAED;;;;;;;;;;OAUG;IACH,KAAK,CAAC,QAAQ,CACZ,OAAuB,EACvB,OAAuC;QAEvC,MAAM,cAAc,GAAG,OAAO,EAAE,cAAc,IAAI,IAAI,CAAC,KAAK,CAAC;QAC7D,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,OAAO,EAAE,cAAc,CAAC,CAAC;QACpE,MAAM,aAAa,GAAG,IAAI,CAAC,mBAAmB,CAAC,QAAQ,EAAE,cAAc,CAAC,CAAC;QACzE,IAAI,CAAC,iBAAiB,CAAC,OAAO,CAAC,UAAU,EAAE,aAAa,CAAC,CAAC;QAC1D,OAAO,aAAa,CAAC;IACvB,CAAC;IAED;;;;;;OAMG;IACH,KAAK,CAAC,qBAAqB,CACzB,OAAuB,EACvB,YAAoB;QAEpB,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC;YACrB,MAAM,MAAM,GAAG,IAAI,CAAC,WAAW,CAAC,YAAY,CAAC,YAAY,CAAC,CAAC;YAC3D,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;gBACpB,OAAO;oBACL,OAAO,EAAE,IAAI;oBACb,KAAK,EAAE,qBAAqB;oBAC5B,mBAAmB,EAAE,MAAM,CAAC,iBAAiB,IAAI,CAAC;iBACnD,CAAC;YACJ,CAAC;QACH,CAAC;QAED,OAAO,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;IAChC,CAAC;IAED;;;;OAIG;IACH,aAAa,CACX,OAAe,EACf,KAA0B;QAE1B,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,IAAI,CAAC,cAAc,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC;YAC3C,OAAO;QACT,CAAC;QAED,IAAI,2BAA2B,CAAC,KAAK,CAAC,EAAE,CAAC;YACvC,IAAI,CAAC,oBAAoB,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;YACvC,OAAO;QACT,CAAC;QAED,MAAM,WAAW,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,OAAO,CAAC,CAAC;QAC7D,IAAI,WAAW,IAAI,yBAAyB,CAAC,WAAW,CAAC,IAAI,KAAK,CAAC,UAAU,KAAK,GAAG,EAAE,CAAC;YACtF,IAAI,CAAC,oBAAoB,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;YACvC,OAAO;QACT,CAAC;QAED,IAAI,YAAY,CAAC,KAAK,CAAC,EAAE,CAAC;YACxB,IAAI,CAAC,cAAc,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC;QAC7C,CAAC;IACH,CAAC;IAED,4DAA4D;IAC5D,iBAAiB;QACf,OAAO,IAAI,CAAC,cAAc,CAAC;IAC7B,CAAC;IAED,kFAAkF;IAClF,kBAAkB,CAAC,OAAe;QAChC,OAAO,IAAI,CAAC,oBAAoB,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IAChD,CAAC;IAED;;OAEG;IACH,cAAc,CAAC,SAAiB;QAC9B,OAAO,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,SAAS,CAAC,IAAI,IAAI,CAAC;IAClD,CAAC;IAED;;;;;OAKG;IACH,cAAc,CACZ,QAAyB,EACzB,kBAAqC,EAAE,EACvC,aAAuC;QAEvC,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAC,eAAe,CAAC,CAAC;QAC1C,MAAM,KAAK,GAAG,aAAa,IAAI,IAAI,CAAC,KAAK,CAAC;QAE1C,MAAM,aAAa,GAAG,IAAI,CAAC,yBAAyB,CAAC,QAAQ,EAAE,QAAQ,EAAE,KAAK,CAAC,CAAC;QAChF,IAAI,aAAa,EAAE,CAAC;YAClB,OAAO,aAAa,CAAC;QACvB,CAAC;QAED,MAAM,QAAQ,GAAG,KAAK,CAAC,MAAM,CAC3B,CAAC,CAAC,EAAE,EAAE,CACJ,CAAC,CAAC,IAAI,KAAK,QAAQ,CAAC,IAAI;YACxB,CAAC,CAAC,EAAE,KAAK,QAAQ,CAAC,iBAAiB;YACnC,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;YACnB,CAAC,CAAC,OAAO,KAAK,KAAK;YACnB,IAAI,CAAC,cAAc,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,CAAC,CACxC,CAAC;QAEF,MAAM,mBAAmB,GAAG,cAAc,CAAC,QAAQ,CAAC,CAAC;QACrD,IAAI,mBAAmB,EAAE,CAAC;YACxB,OAAO;gBACL,GAAG,QAAQ;gBACX,iBAAiB,EAAE,mBAAmB,CAAC,EAAE;gBACzC,WAAW,EAAE,0BAA0B;aACxC,CAAC;QACJ,CAAC;QAED,MAAM,UAAU,GAAG,KAAK,CAAC,MAAM,CAC7B,CAAC,CAAC,EAAE,EAAE,CACJ,CAAC,CAAC,EAAE,KAAK,QAAQ,CAAC,iBAAiB;YACnC,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;YACnB,CAAC,CAAC,OAAO,KAAK,KAAK;YACnB,IAAI,CAAC,cAAc,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,CAAC,CACxC,CAAC;QAEF,MAAM,QAAQ,GAAG,cAAc,CAAC,UAAU,CAAC,CAAC;QAC5C,IAAI,QAAQ,EAAE,CAAC;YACb,OAAO;gBACL,GAAG,QAAQ;gBACX,iBAAiB,EAAE,QAAQ,CAAC,EAAE;gBAC9B,IAAI,EAAE,QAAQ,CAAC,IAAI;gBACnB,WAAW,EAAE,0BAA0B;aACxC,CAAC;QACJ,CAAC;QAED,OAAO,SAAS,CAAC;IACnB,CAAC;IAED;;;;OAIG;IACK,mBAAmB,CACzB,QAAyB,EACzB,QAAiC,IAAI,CAAC,KAAK;QAE3C,IAAI,IAAI,CAAC,cAAc,CAAC,WAAW,CAAC,QAAQ,CAAC,iBAAiB,CAAC,EAAE,CAAC;YAChE,OAAO,QAAQ,CAAC;QAClB,CAAC;QAED,OAAO,IAAI,CAAC,cAAc,CAAC,QAAQ,EAAE,EAAE,EAAE,KAAK,CAAC,IAAI,QAAQ,CAAC;IAC9D,CAAC;IAED;;;OAGG;IACK,yBAAyB,CAC/B,QAAyB,EACzB,QAA6B,EAC7B,KAA8B;QAE9B,MAAM,SAAS,GAAG,CAAC,QAAQ,CAAC,iBAAiB,EAAE,GAAG,QAAQ,CAAC,CAAC;QAC5D,MAAM,WAAW,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,IAAI,CAAC,oBAAoB,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC;QAC9E,IAAI,CAAC,WAAW,EAAE,CAAC;YACjB,OAAO,SAAS,CAAC;QACnB,CAAC;QAED,MAAM,WAAW,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,QAAQ,CAAC,iBAAiB,CAAC,CAAC;QAC3E,IAAI,WAAW,IAAI,CAAC,yBAAyB,CAAC,WAAW,CAAC,EAAE,CAAC;YAC3D,OAAO,SAAS,CAAC;QACnB,CAAC;QAED,MAAM,UAAU,GAAG,KAAK,CAAC,IAAI,CAC3B,CAAC,CAAC,EAAE,EAAE,CACJ,iBAAiB,CAAC,CAAC,CAAC;YACpB,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;YACnB,CAAC,CAAC,EAAE,KAAK,QAAQ,CAAC,iBAAiB;YACnC,CAAC,CAAC,OAAO,KAAK,KAAK;YACnB,IAAI,CAAC,cAAc,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,CAAC,CACxC,CAAC;QACF,IAAI,UAAU,EAAE,CAAC;YACf,OAAO;gBACL,GAAG,QAAQ;gBACX,iBAAiB,EAAE,UAAU,CAAC,EAAE;gBAChC,IAAI,EAAE,UAAU,CAAC,IAAI;gBACrB,WAAW,EAAE,wBAAwB;aACtC,CAAC;QACJ,CAAC;QAED,MAAM,UAAU,GAAG,KAAK,CAAC,MAAM,CAC7B,CAAC,CAAC,EAAE,EAAE,CACJ,CAAC,CAAC,IAAI,KAAK,kBAAkB;YAC7B,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;YACnB,CAAC,CAAC,EAAE,KAAK,QAAQ,CAAC,iBAAiB;YACnC,CAAC,CAAC,OAAO,KAAK,KAAK;YACnB,CAAC,yBAAyB,CAAC,CAAC,CAAC;YAC7B,IAAI,CAAC,cAAc,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,CAAC,CACxC,CAAC;QACF,MAAM,kBAAkB,GAAG,cAAc,CAAC,UAAU,CAAC,CAAC;QACtD,IAAI,kBAAkB,EAAE,CAAC;YACvB,OAAO;gBACL,GAAG,QAAQ;gBACX,iBAAiB,EAAE,kBAAkB,CAAC,EAAE;gBACxC,IAAI,EAAE,kBAAkB,CAAC,IAAI;gBAC7B,WAAW,EAAE,wBAAwB;aACtC,CAAC;QACJ,CAAC;QAED,OAAO,SAAS,CAAC;IACnB,CAAC;IAED;;;;OAIG;IACK,iBAAiB,CACvB,SAAiB,EACjB,QAAyB;QAEzB,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,QAAQ,CAAC,iBAAiB,CAAC,CAAC;QAC1E,IAAI,CAAC,KAAK;YAAE,OAAO;QAEnB,MAAM,QAAQ,GAAG,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QAElD,IACE,QAAQ;YACR,QAAQ,CAAC,QAAQ,KAAK,KAAK,CAAC,QAAQ;YACpC,QAAQ,CAAC,WAAW,KAAK,uBAAuB,EAChD,CAAC;YACD,OAAO;QACT,CAAC;QAED,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,SAAS,EAAE;YAC/B,SAAS;YACT,QAAQ,EAAE,KAAK,CAAC,QAAQ;YACxB,OAAO,EAAE,KAAK,CAAC,EAAE;YACjB,aAAa,EAAE,KAAK,CAAC,WAAW,EAAE,cAAc,IAAI,KAAK;SAC1D,CAAC,CAAC;IACL,CAAC;CACF"}

package/dist/infrastructure/hardware/hardware-probe.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Hardware probe — T044, FR-012.
+ *
+ * Three-state gate: inspects platform/arch, unified memory, and battery
+ * to return `full_local`, `classification_only`, or `disabled`.
+ *
+ * Pure function of SystemInfo × config; side-effect-free for testability.
+ * Default SystemInfo provider reads from Node.js `os` and platform-specific
+ * power sources (macOS pmset, Linux /sys/class/power_supply, Windows WMI).
+ */
+export type HardwareProbeResult = 'full_local' | 'classification_only' | 'disabled';
+export interface HardwareProbeConfig {
+    readonly min_memory_gb_full: number;
+    readonly min_memory_gb_classification: number;
+    readonly battery_threshold_pct: number;
+}
+export interface SystemInfo {
+    readonly totalMemoryGb: number;
+    readonly arch: string;
+    readonly platform: NodeJS.Platform;
+    readonly batteryLevel: number | null;
+    readonly isOnAcPower: boolean | null;
+}
+/** Port for dependency injection in tests. */
+export interface SystemInfoPort {
+    getSystemInfo(): Promise<SystemInfo>;
+}
+export declare function probeHardware(config: HardwareProbeConfig, info: SystemInfo): HardwareProbeResult;
+export declare function getDefaultSystemInfoPort(): SystemInfoPort;
+export declare function getDefaultSystemInfo(): Promise<SystemInfo>;
+export declare function probeHardwareDefault(config: HardwareProbeConfig): Promise<HardwareProbeResult>;
+//# sourceMappingURL=hardware-probe.d.ts.map

package/dist/infrastructure/hardware/hardware-probe.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hardware-probe.d.ts","sourceRoot":"","sources":["../../../src/infrastructure/hardware/hardware-probe.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AASH,MAAM,MAAM,mBAAmB,GAAG,YAAY,GAAG,qBAAqB,GAAG,UAAU,CAAC;AAEpF,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,kBAAkB,EAAE,MAAM,CAAC;IACpC,QAAQ,CAAC,4BAA4B,EAAE,MAAM,CAAC;IAC9C,QAAQ,CAAC,qBAAqB,EAAE,MAAM,CAAC;CACxC;AAED,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC,QAAQ,CAAC;IACnC,QAAQ,CAAC,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IACrC,QAAQ,CAAC,WAAW,EAAE,OAAO,GAAG,IAAI,CAAC;CACtC;AAED,8CAA8C;AAC9C,MAAM,WAAW,cAAc;IAC7B,aAAa,IAAI,OAAO,CAAC,UAAU,CAAC,CAAC;CACtC;AAiBD,wBAAgB,aAAa,CAC3B,MAAM,EAAE,mBAAmB,EAC3B,IAAI,EAAE,UAAU,GACf,mBAAmB,CAsBrB;AA4KD,wBAAgB,wBAAwB,IAAI,cAAc,CAWzD;AAED,wBAAsB,oBAAoB,IAAI,OAAO,CAAC,UAAU,CAAC,CAEhE;AAID,wBAAsB,oBAAoB,CACxC,MAAM,EAAE,mBAAmB,GAC1B,OAAO,CAAC,mBAAmB,CAAC,CAG9B"}

package/dist/infrastructure/hardware/hardware-probe.js

@@ -0,0 +1,199 @@
+/**
+ * Hardware probe — T044, FR-012.
+ *
+ * Three-state gate: inspects platform/arch, unified memory, and battery
+ * to return `full_local`, `classification_only`, or `disabled`.
+ *
+ * Pure function of SystemInfo × config; side-effect-free for testability.
+ * Default SystemInfo provider reads from Node.js `os` and platform-specific
+ * power sources (macOS pmset, Linux /sys/class/power_supply, Windows WMI).
+ */
+import * as os from 'node:os';
+import { execSync } from 'node:child_process';
+import { existsSync, readdirSync, readFileSync } from 'node:fs';
+import { join } from 'node:path';
+// ─── Pure probe logic ────────────────────────────────────────────────────────
+function isSupportedPlatform(info) {
+    if (info.platform === 'darwin' && info.arch === 'arm64') {
+        return true;
+    }
+    if (info.platform === 'linux' && (info.arch === 'x64' || info.arch === 'arm64')) {
+        return true;
+    }
+    if (info.platform === 'win32' && (info.arch === 'x64' || info.arch === 'arm64')) {
+        return true;
+    }
+    return false;
+}
+export function probeHardware(config, info) {
+    if (!isSupportedPlatform(info)) {
+        return 'disabled';
+    }
+    if (info.isOnAcPower === false &&
+        info.batteryLevel !== null &&
+        info.batteryLevel < config.battery_threshold_pct) {
+        return 'disabled';
+    }
+    if (info.totalMemoryGb >= config.min_memory_gb_full) {
+        return 'full_local';
+    }
+    if (info.totalMemoryGb >= config.min_memory_gb_classification) {
+        return 'classification_only';
+    }
+    return 'disabled';
+}
+// ─── Platform-specific system info providers ───────────────────────────────
+function parseBatteryInfo(output) {
+    const pctMatch = /(\d+)%/.exec(output);
+    const batteryLevel = pctMatch?.[1] !== undefined
+        ? parseInt(pctMatch[1], 10)
+        : null;
+    const isOnAcPower = output.includes('AC Power');
+    return { batteryLevel, isOnAcPower };
+}
+function readLinuxPowerInfo() {
+    const powerSupplyDir = '/sys/class/power_supply';
+    if (!existsSync(powerSupplyDir)) {
+        return { batteryLevel: null, isOnAcPower: true };
+    }
+    try {
+        const entries = readdirSync(powerSupplyDir);
+        let batteryLevel = null;
+        let isOnAcPower = null;
+        for (const name of entries) {
+            const base = join(powerSupplyDir, name);
+            const typePath = join(base, 'type');
+            if (!existsSync(typePath)) {
+                continue;
+            }
+            const type = readFileSync(typePath, 'utf8').trim();
+            if (type !== 'Battery') {
+                continue;
+            }
+            const capacityPath = join(base, 'capacity');
+            if (existsSync(capacityPath)) {
+                const capacity = parseInt(readFileSync(capacityPath, 'utf8').trim(), 10);
+                if (!Number.isNaN(capacity)) {
+                    batteryLevel = capacity;
+                }
+            }
+            const statusPath = join(base, 'status');
+            if (existsSync(statusPath)) {
+                const status = readFileSync(statusPath, 'utf8').trim();
+                isOnAcPower = status === 'Charging' || status === 'Full' || status === 'Not charging';
+            }
+            break;
+        }
+        if (batteryLevel === null && isOnAcPower === null) {
+            return { batteryLevel: null, isOnAcPower: true };
+        }
+        return { batteryLevel, isOnAcPower };
+    }
+    catch {
+        return { batteryLevel: null, isOnAcPower: true };
+    }
+}
+function buildBaseSystemInfo() {
+    return {
+        totalMemoryGb: os.totalmem() / 1024 ** 3,
+        arch: os.arch(),
+        platform: os.platform(),
+    };
+}
+const macOsSystemInfoPort = {
+    async getSystemInfo() {
+        let batteryLevel = null;
+        let isOnAcPower = null;
+        try {
+            const output = execSync('pmset -g batt', {
+                timeout: 2000,
+                encoding: 'utf8',
+            });
+            const parsed = parseBatteryInfo(output);
+            batteryLevel = parsed.batteryLevel;
+            isOnAcPower = parsed.isOnAcPower;
+        }
+        catch {
+            isOnAcPower = true;
+        }
+        return {
+            ...buildBaseSystemInfo(),
+            batteryLevel,
+            isOnAcPower,
+        };
+    },
+};
+const linuxSystemInfoPort = {
+    async getSystemInfo() {
+        const power = readLinuxPowerInfo();
+        return {
+            ...buildBaseSystemInfo(),
+            batteryLevel: power.batteryLevel,
+            isOnAcPower: power.isOnAcPower,
+        };
+    },
+};
+function readWindowsPowerInfo() {
+    try {
+        const output = execSync('powershell -NoProfile -Command "Get-CimInstance -ClassName Win32_Battery -ErrorAction SilentlyContinue | Select-Object -First 1 EstimatedChargeRemaining, BatteryStatus | ConvertTo-Json -Compress"', { timeout: 3000, encoding: 'utf8' }).trim();
+        if (!output) {
+            return { batteryLevel: null, isOnAcPower: true };
+        }
+        const parsed = JSON.parse(output);
+        const batteryLevel = typeof parsed.EstimatedChargeRemaining === 'number'
+            ? parsed.EstimatedChargeRemaining
+            : null;
+        let isOnAcPower = null;
+        if (typeof parsed.BatteryStatus === 'number') {
+            // 1 = discharging; other values indicate AC/charging/full states.
+            isOnAcPower = parsed.BatteryStatus !== 1;
+        }
+        if (batteryLevel === null && isOnAcPower === null) {
+            return { batteryLevel: null, isOnAcPower: true };
+        }
+        return { batteryLevel, isOnAcPower };
+    }
+    catch {
+        return { batteryLevel: null, isOnAcPower: true };
+    }
+}
+const windowsSystemInfoPort = {
+    async getSystemInfo() {
+        const power = readWindowsPowerInfo();
+        return {
+            ...buildBaseSystemInfo(),
+            batteryLevel: power.batteryLevel,
+            isOnAcPower: power.isOnAcPower,
+        };
+    },
+};
+const genericSystemInfoPort = {
+    async getSystemInfo() {
+        return {
+            ...buildBaseSystemInfo(),
+            batteryLevel: null,
+            isOnAcPower: null,
+        };
+    },
+};
+export function getDefaultSystemInfoPort() {
+    switch (os.platform()) {
+        case 'darwin':
+            return macOsSystemInfoPort;
+        case 'linux':
+            return linuxSystemInfoPort;
+        case 'win32':
+            return windowsSystemInfoPort;
+        default:
+            return genericSystemInfoPort;
+    }
+}
+export async function getDefaultSystemInfo() {
+    return getDefaultSystemInfoPort().getSystemInfo();
+}
+// ─── Convenience: probe with real system info ────────────────────────────────
+export async function probeHardwareDefault(config) {
+    const info = await getDefaultSystemInfo();
+    return probeHardware(config, info);
+}
+//# sourceMappingURL=hardware-probe.js.map

package/dist/infrastructure/hardware/hardware-probe.js.map

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

package/dist/infrastructure/local/local-zero-tier.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Local zero-tier readiness pings — T045, FR-012, FR-013.
+ *
+ * Pings LM Studio and Ollama HTTP endpoints in parallel to determine
+ * whether a local model is loaded and ready. Combined latency target <15ms.
+ *
+ * Never throws — unreachable services return `available: false`.
+ * Port-based HTTP for testability; default uses Node.js global fetch.
+ */
+export interface ServicePingResult {
+    readonly available: boolean;
+    readonly hasLoadedModel: boolean;
+    readonly latencyMs: number;
+}
+export interface LocalReadinessResult {
+    readonly lmStudio: ServicePingResult;
+    readonly ollama: ServicePingResult;
+    readonly anyModelReady: boolean;
+    readonly combinedLatencyMs: number;
+}
+export interface LocalZeroTierConfig {
+    readonly lmStudioBaseUrl: string;
+    readonly ollamaBaseUrl: string;
+    readonly pingTimeoutMs: number;
+}
+/** Port for HTTP fetch — allows stubbing in tests without network. */
+export interface HttpFetchPort {
+    fetch(url: string, init: {
+        signal: AbortSignal;
+    }): Promise<{
+        ok: boolean;
+        json(): Promise<unknown>;
+    }>;
+}
+export declare const DEFAULT_LOCAL_CONFIG: LocalZeroTierConfig;
+/**
+ * Default HTTP fetch port using Node.js global fetch.
+ */
+export declare const defaultHttpFetch: HttpFetchPort;
+/**
+ * Ping LM Studio and Ollama in parallel. Returns readiness state for each
+ * service and whether any local model is loaded and ready for inference.
+ *
+ * Combined latency target: <15ms on a healthy system.
+ */
+export declare function pingLocalServices(config?: LocalZeroTierConfig, httpFetch?: HttpFetchPort): Promise<LocalReadinessResult>;
+//# sourceMappingURL=local-zero-tier.d.ts.map

package/dist/infrastructure/local/local-zero-tier.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"local-zero-tier.d.ts","sourceRoot":"","sources":["../../../src/infrastructure/local/local-zero-tier.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,cAAc,EAAE,OAAO,CAAC;IACjC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B;AAED,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,QAAQ,EAAE,iBAAiB,CAAC;IACrC,QAAQ,CAAC,MAAM,EAAE,iBAAiB,CAAC;IACnC,QAAQ,CAAC,aAAa,EAAE,OAAO,CAAC;IAChC,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;CACpC;AAED,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;CAChC;AAED,sEAAsE;AACtE,MAAM,WAAW,aAAa;IAC5B,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE;QAAE,MAAM,EAAE,WAAW,CAAA;KAAE,GAAG,OAAO,CAAC;QACzD,EAAE,EAAE,OAAO,CAAC;QACZ,IAAI,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;KAC1B,CAAC,CAAC;CACJ;AAID,eAAO,MAAM,oBAAoB,EAAE,mBAIlC,CAAC;AA4DF;;GAEG;AACH,eAAO,MAAM,gBAAgB,EAAE,aAE9B,CAAC;AAEF;;;;;GAKG;AACH,wBAAsB,iBAAiB,CACrC,MAAM,GAAE,mBAA0C,EAClD,SAAS,GAAE,aAAgC,GAC1C,OAAO,CAAC,oBAAoB,CAAC,CA6B/B"}