pi-smart-router 0.1.0

package/dist/index.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Public package exports — pi-smart-router.
+ *
+ * Exposes the router factory (T022) and pi lifecycle hook registrar (T021).
+ * Full pi integration uses `.pi/extensions/smart-router/`; library embedders
+ * route via `dispatch.dispatch()` after calling `register(hooks)`.
+ */
+import type { ModelProfile, RoutingDecision } from './domain/types/index.js';
+import { type FleetCatalog } from './config/models-loader.js';
+import { loadRoutingClusters, clusterReasonCode, type TextEmbedder } from './config/routing-clusters-loader.js';
+import { GatewayDispatch, type GatewayDispatchOptions } from './infrastructure/gateway/gateway-dispatch.js';
+import { LifecycleHookState, type PiRouterMiddleware, type PiExtensionHooks } from './api/middleware/pi-router-middleware.js';
+/** Package identifier for diagnostics and telemetry. */
+export declare const PACKAGE_NAME: "pi-smart-router";
+export interface RouterFactoryOptions {
+    readonly modelsPath?: string;
+}
+export interface RouterHandle {
+    readonly version: string;
+    readonly middleware: PiRouterMiddleware;
+    readonly dispatch: GatewayDispatch;
+    readonly fleet: readonly ModelProfile[];
+    readonly register: (hooks: PiExtensionHooks) => void;
+}
+export declare function createRouter(options?: RouterFactoryOptions): RouterHandle;
+export declare function createRouterFromCatalog(catalog: FleetCatalog): RouterHandle;
+export interface CreateRouterFromFleetOptions extends GatewayDispatchOptions {
+    readonly lifecycleHookState?: LifecycleHookState;
+}
+export declare function createRouterFromFleet(fleet: ModelProfile[], options?: CreateRouterFromFleetOptions): RouterHandle;
+export type { RoutingDecision, ModelProfile };
+export { loadRoutingClusters, clusterReasonCode, };
+export type { TextEmbedder };
+export type { RoutingClusterCatalog } from './domain/types/index.js';
+export type { PiRouterMiddleware, PiRouterMiddlewareOptions, PiExtensionHooks, PiExtensionContext, PiProviderRequestEvent, PiContextEvent, PiModelSelectEvent, PiSessionManager, LifecycleFlags, } from './api/middleware/pi-router-middleware.js';
+export { createPiRouterMiddleware, LifecycleHookState } from './api/middleware/pi-router-middleware.js';
+export type { GatewayDispatchOptions } from './infrastructure/gateway/gateway-dispatch.js';
+export type { PipelineOptions } from './domain/pipeline/router-pipeline.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAC7E,OAAO,EAAc,KAAK,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAC1E,OAAO,EACL,mBAAmB,EACnB,iBAAiB,EACjB,KAAK,YAAY,EAClB,MAAM,qCAAqC,CAAC;AAC7C,OAAO,EACL,eAAe,EACf,KAAK,sBAAsB,EAC5B,MAAM,8CAA8C,CAAC;AACtD,OAAO,EAEL,kBAAkB,EAClB,KAAK,kBAAkB,EACvB,KAAK,gBAAgB,EACtB,MAAM,0CAA0C,CAAC;AAElD,wDAAwD;AACxD,eAAO,MAAM,YAAY,EAAG,iBAA0B,CAAC;AAIvD,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;CAC9B;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,UAAU,EAAE,kBAAkB,CAAC;IACxC,QAAQ,CAAC,QAAQ,EAAE,eAAe,CAAC;IACnC,QAAQ,CAAC,KAAK,EAAE,SAAS,YAAY,EAAE,CAAC;IACxC,QAAQ,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,gBAAgB,KAAK,IAAI,CAAC;CACtD;AAID,wBAAgB,YAAY,CAAC,OAAO,CAAC,EAAE,oBAAoB,GAAG,YAAY,CAMzE;AAED,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,YAAY,GAAG,YAAY,CAE3E;AAED,MAAM,WAAW,4BAA6B,SAAQ,sBAAsB;IAC1E,QAAQ,CAAC,kBAAkB,CAAC,EAAE,kBAAkB,CAAC;CAClD;AAED,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,YAAY,EAAE,EACrB,OAAO,CAAC,EAAE,4BAA4B,GACrC,YAAY,CAcd;AAID,YAAY,EAAE,eAAe,EAAE,YAAY,EAAE,CAAC;AAC9C,OAAO,EACL,mBAAmB,EACnB,iBAAiB,GAClB,CAAC;AACF,YAAY,EAAE,YAAY,EAAE,CAAC;AAC7B,YAAY,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AACrE,YAAY,EACV,kBAAkB,EAClB,yBAAyB,EACzB,gBAAgB,EAChB,kBAAkB,EAClB,sBAAsB,EACtB,cAAc,EACd,kBAAkB,EAClB,gBAAgB,EAChB,cAAc,GACf,MAAM,0CAA0C,CAAC;AAClD,OAAO,EAAE,wBAAwB,EAAE,kBAAkB,EAAE,MAAM,0CAA0C,CAAC;AACxG,YAAY,EAAE,sBAAsB,EAAE,MAAM,8CAA8C,CAAC;AAC3F,YAAY,EAAE,eAAe,EAAE,MAAM,sCAAsC,CAAC"}

package/dist/index.js

@@ -0,0 +1,36 @@
+/**
+ * Public package exports — pi-smart-router.
+ *
+ * Exposes the router factory (T022) and pi lifecycle hook registrar (T021).
+ * Full pi integration uses `.pi/extensions/smart-router/`; library embedders
+ * route via `dispatch.dispatch()` after calling `register(hooks)`.
+ */
+import { loadModels } from './config/models-loader.js';
+import { loadRoutingClusters, clusterReasonCode, } from './config/routing-clusters-loader.js';
+import { GatewayDispatch, } from './infrastructure/gateway/gateway-dispatch.js';
+import { createPiRouterMiddleware, } from './api/middleware/pi-router-middleware.js';
+/** Package identifier for diagnostics and telemetry. */
+export const PACKAGE_NAME = 'pi-smart-router';
+// ─── Router factory (T022) ───────────────────────────────────────────────────
+export function createRouter(options) {
+    const catalog = loadModels(options?.modelsPath ? { filePath: options.modelsPath } : undefined);
+    return createRouterFromCatalog(catalog);
+}
+export function createRouterFromCatalog(catalog) {
+    return createRouterFromFleet([...catalog.models]);
+}
+export function createRouterFromFleet(fleet, options) {
+    const { lifecycleHookState, ...dispatchOptions } = options ?? {};
+    const dispatch = new GatewayDispatch(fleet, dispatchOptions);
+    const middleware = createPiRouterMiddleware(lifecycleHookState !== undefined ? { lifecycleHookState } : undefined);
+    return {
+        version: 'pi-smart-router',
+        middleware,
+        dispatch,
+        fleet,
+        register: middleware.register,
+    };
+}
+export { loadRoutingClusters, clusterReasonCode, };
+export { createPiRouterMiddleware, LifecycleHookState } from './api/middleware/pi-router-middleware.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,EAAE,UAAU,EAAqB,MAAM,2BAA2B,CAAC;AAC1E,OAAO,EACL,mBAAmB,EACnB,iBAAiB,GAElB,MAAM,qCAAqC,CAAC;AAC7C,OAAO,EACL,eAAe,GAEhB,MAAM,8CAA8C,CAAC;AACtD,OAAO,EACL,wBAAwB,GAIzB,MAAM,0CAA0C,CAAC;AAElD,wDAAwD;AACxD,MAAM,CAAC,MAAM,YAAY,GAAG,iBAA0B,CAAC;AAgBvD,gFAAgF;AAEhF,MAAM,UAAU,YAAY,CAAC,OAA8B;IACzD,MAAM,OAAO,GAAG,UAAU,CACxB,OAAO,EAAE,UAAU,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,OAAO,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,SAAS,CACnE,CAAC;IAEF,OAAO,uBAAuB,CAAC,OAAO,CAAC,CAAC;AAC1C,CAAC;AAED,MAAM,UAAU,uBAAuB,CAAC,OAAqB;IAC3D,OAAO,qBAAqB,CAAC,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC;AACpD,CAAC;AAMD,MAAM,UAAU,qBAAqB,CACnC,KAAqB,EACrB,OAAsC;IAEtC,MAAM,EAAE,kBAAkB,EAAE,GAAG,eAAe,EAAE,GAAG,OAAO,IAAI,EAAE,CAAC;IACjE,MAAM,QAAQ,GAAG,IAAI,eAAe,CAAC,KAAK,EAAE,eAAe,CAAC,CAAC;IAC7D,MAAM,UAAU,GAAG,wBAAwB,CACzC,kBAAkB,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,kBAAkB,EAAE,CAAC,CAAC,CAAC,SAAS,CACtE,CAAC;IAEF,OAAO;QACL,OAAO,EAAE,iBAAiB;QAC1B,UAAU;QACV,QAAQ;QACR,KAAK;QACL,QAAQ,EAAE,UAAU,CAAC,QAAQ;KAC9B,CAAC;AACJ,CAAC;AAKD,OAAO,EACL,mBAAmB,EACnB,iBAAiB,GAClB,CAAC;AAcF,OAAO,EAAE,wBAAwB,EAAE,kBAAkB,EAAE,MAAM,0CAA0C,CAAC"}

package/dist/infra/gemini-provider.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Gemini provider error classification and failover policy.
+ *
+ * thought_signature 400s are client/protocol validation errors (FR-018),
+ * not infrastructure outages — they must return terminal errors, not trigger
+ * stream delegation failover.
+ */
+import type { AssistantMessage } from '@earendil-works/pi-ai/compat';
+export interface GeminiProviderError {
+    readonly statusCode?: number;
+    readonly code?: string;
+    readonly message?: string;
+}
+/**
+ * Gemini returns 400 INVALID_ARGUMENT when tool-call replay omits thought_signature.
+ */
+export declare function isGeminiThoughtSignatureError(parsed: GeminiProviderError): boolean;
+export declare function isGeminiThoughtSignatureAssistantError(message: AssistantMessage): boolean;
+/**
+ * Returns true when a Gemini provider error should trigger failover.
+ * thought_signature validation failures are terminal — never failover.
+ */
+export declare function shouldFailoverOnGeminiError(parsed: GeminiProviderError): boolean;
+/**
+ * Format a Gemini thought_signature validation error with operator workarounds.
+ */
+export declare function formatGeminiThoughtSignatureErrorMessage(errorMessage: string): string;
+//# sourceMappingURL=gemini-provider.d.ts.map

package/dist/infra/gemini-provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gemini-provider.d.ts","sourceRoot":"","sources":["../../src/infra/gemini-provider.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AAErE,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED;;GAEG;AACH,wBAAgB,6BAA6B,CAAC,MAAM,EAAE,mBAAmB,GAAG,OAAO,CAKlF;AAED,wBAAgB,sCAAsC,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAKzF;AAED;;;GAGG;AACH,wBAAgB,2BAA2B,CAAC,MAAM,EAAE,mBAAmB,GAAG,OAAO,CAKhF;AAMD;;GAEG;AACH,wBAAgB,wCAAwC,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,CAsBrF"}

package/dist/infra/gemini-provider.js

@@ -0,0 +1,112 @@
+/**
+ * Gemini provider error classification and failover policy.
+ *
+ * thought_signature 400s are client/protocol validation errors (FR-018),
+ * not infrastructure outages — they must return terminal errors, not trigger
+ * stream delegation failover.
+ */
+/**
+ * Gemini returns 400 INVALID_ARGUMENT when tool-call replay omits thought_signature.
+ */
+export function isGeminiThoughtSignatureError(parsed) {
+    return (parsed.statusCode === 400 &&
+        parsed.message?.includes('thought_signature') === true);
+}
+export function isGeminiThoughtSignatureAssistantError(message) {
+    if (message.stopReason !== 'error' || !message.errorMessage) {
+        return false;
+    }
+    return isGeminiThoughtSignatureError(parseGeminiErrorBlob(message.errorMessage));
+}
+/**
+ * Returns true when a Gemini provider error should trigger failover.
+ * thought_signature validation failures are terminal — never failover.
+ */
+export function shouldFailoverOnGeminiError(parsed) {
+    if (isGeminiThoughtSignatureError(parsed)) {
+        return false;
+    }
+    return parsed.statusCode !== undefined && (parsed.statusCode >= 500 || parsed.statusCode === 429);
+}
+const GEMINI_THOUGHT_SIGNATURE_DOCS = 'https://ai.google.dev/gemini-api/docs/generate-content/thought-signatures';
+const PI_THOUGHT_SIGNATURE_ISSUE = 'https://github.com/earendil-works/pi/issues/6342';
+/**
+ * Format a Gemini thought_signature validation error with operator workarounds.
+ */
+export function formatGeminiThoughtSignatureErrorMessage(errorMessage) {
+    const parsed = parseGeminiErrorBlob(errorMessage);
+    const prefixParts = [];
+    if (parsed.statusCode !== undefined) {
+        prefixParts.push(String(parsed.statusCode));
+    }
+    if (parsed.code) {
+        prefixParts.push(parsed.code);
+    }
+    const summary = parsed.message && prefixParts.length > 0
+        ? `${prefixParts.join(' ')}: ${parsed.message}`
+        : parsed.message ?? 'Provider error (thought_signature validation)';
+    return [
+        summary,
+        '',
+        'Gemini rejected this request because a prior tool call is missing its thought_signature (protocol validation, not provider outage).',
+        'Workarounds: start a fresh session with /new, or route to a non-Google model until pi preserves thought signatures in replay.',
+        `Docs: ${GEMINI_THOUGHT_SIGNATURE_DOCS}`,
+        `Upstream: ${PI_THOUGHT_SIGNATURE_ISSUE}`,
+    ].join('\n');
+}
+function parseGeminiErrorBlob(errorMessage) {
+    const trimmed = errorMessage.trim();
+    if (!trimmed.startsWith('{')) {
+        return trimmed.includes('thought_signature') ? { statusCode: 400, message: trimmed } : {};
+    }
+    try {
+        const parsed = JSON.parse(trimmed);
+        const nested = parsed.error;
+        const statusCode = parseNumericCode(nested?.code) ??
+            parseNumericCode(nested?.status) ??
+            parseNumericCode(parsed.code) ??
+            parseNumericCode(parsed.status);
+        const code = typeof nested?.status === 'string'
+            ? nested.status
+            : typeof parsed.status === 'string'
+                ? parsed.status
+                : undefined;
+        let message = typeof nested?.message === 'string'
+            ? nested.message
+            : typeof parsed.message === 'string'
+                ? parsed.message
+                : undefined;
+        if (message?.trim().startsWith('{')) {
+            try {
+                const inner = JSON.parse(message);
+                if (typeof inner.error?.message === 'string') {
+                    message = inner.error.message;
+                }
+                else if (typeof inner.message === 'string') {
+                    message = inner.message;
+                }
+            }
+            catch {
+                // keep outer message
+            }
+        }
+        return {
+            ...(statusCode !== undefined ? { statusCode } : {}),
+            ...(code ? { code } : {}),
+            ...(message ? { message } : {}),
+        };
+    }
+    catch {
+        return {};
+    }
+}
+function parseNumericCode(value) {
+    if (typeof value === 'number' && Number.isFinite(value)) {
+        return value;
+    }
+    if (typeof value === 'string' && /^\d+$/.test(value)) {
+        return Number.parseInt(value, 10);
+    }
+    return undefined;
+}
+//# sourceMappingURL=gemini-provider.js.map

package/dist/infra/gemini-provider.js.map

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

package/dist/infra/telemetry.d.ts

@@ -0,0 +1,51 @@
+/**
+ * Privacy-safe community telemetry export (SP-082).
+ *
+ * Maps routing telemetry rows to anonymized community export shapes and
+ * HyDRA calibration batches. Never exports prompt text, messages, request_id,
+ * or raw session_id — session identifiers are one-way hashed only.
+ */
+import type { RoutingFeatureSidecar, RoutingTelemetry } from '../domain/types/index.js';
+export declare const COMMUNITY_TELEMETRY_ENABLED_ENV = "SMART_ROUTER_COMMUNITY_TELEMETRY";
+export declare const COMMUNITY_TELEMETRY_ENABLED_NOTIFY_MESSAGE = "Smart Router community telemetry export is enabled. Only anonymized routing metadata is exported \u2014 no prompt text, messages, or raw session identifiers.";
+export declare const TELEMETRY_EXPORT_FORBIDDEN_KEYS: readonly ["session_id", "request_id", "prompt_text", "messages", "prompt", "pepper", "install_pepper", "dataset_pepper", "dataset_key", "prompt_fingerprint"];
+export declare const HYDRA_CALIBRATION_STAGE: "hydra_match";
+export declare function isCommunityTelemetryExportEnabled(): boolean;
+/** One-way hash for session correlation without exporting raw session_id. */
+export declare function hashSessionIdForTelemetryExport(sessionId: string): string;
+export interface CommunityTelemetryRecord {
+    readonly timestamp: string;
+    readonly session_id_hash: string;
+    readonly turn_type: string;
+    readonly stage: string;
+    readonly reason_code: string;
+    readonly selected_model_id: string;
+    readonly estimated_cost_usd: number;
+    readonly routing_latency_ms: number;
+    readonly pin_reason: string | null;
+}
+/** HyDRA calibration row — routing signals only, no prompt content. */
+export interface HydraCalibrationRecord {
+    readonly timestamp: string;
+    readonly session_id_hash: string;
+    readonly turn_type: string;
+    readonly reason_code: string;
+    readonly selected_model_id: string;
+    readonly routing_latency_ms: number;
+    readonly requirement_reasoning: number | null;
+    readonly requirement_code_gen: number | null;
+    readonly requirement_tool_use: number | null;
+    readonly top_candidate_model_id: string | null;
+    readonly top_candidate_score: number | null;
+}
+export declare function isHydraMatchTelemetry(record: RoutingTelemetry): boolean;
+export declare function selectHydraMatchTelemetry(records: readonly RoutingTelemetry[]): readonly RoutingTelemetry[];
+/** Map a telemetry row to a privacy-safe community export object. */
+export declare function toCommunityTelemetryRecord(record: RoutingTelemetry): CommunityTelemetryRecord;
+/** Map a hydra_match telemetry row to a collaborative calibration export row. */
+export declare function toHydraCalibrationRecord(record: RoutingTelemetry, features?: RoutingFeatureSidecar): HydraCalibrationRecord;
+export declare function formatCommunityTelemetryJsonl(records: readonly RoutingTelemetry[]): string;
+export declare function formatHydraCalibrationJsonl(records: readonly RoutingTelemetry[], featuresByRequestId?: ReadonlyMap<string, RoutingFeatureSidecar>): string;
+/** Defense-in-depth scrub for loose export objects. */
+export declare function scrubTelemetryExportObject(value: Record<string, unknown>): Record<string, unknown>;
+//# sourceMappingURL=telemetry.d.ts.map

package/dist/infra/telemetry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"telemetry.d.ts","sourceRoot":"","sources":["../../src/infra/telemetry.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,OAAO,KAAK,EACV,qBAAqB,EACrB,gBAAgB,EACjB,MAAM,0BAA0B,CAAC;AAElC,eAAO,MAAM,+BAA+B,qCAAqC,CAAC;AAElF,eAAO,MAAM,0CAA0C,kKACqG,CAAC;AAE7J,eAAO,MAAM,+BAA+B,+JAWlC,CAAC;AAEX,eAAO,MAAM,uBAAuB,EAAG,aAAsB,CAAC;AAE9D,wBAAgB,iCAAiC,IAAI,OAAO,CAE3D;AAED,6EAA6E;AAC7E,wBAAgB,+BAA+B,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAEzE;AAED,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;IACnC,QAAQ,CAAC,kBAAkB,EAAE,MAAM,CAAC;IACpC,QAAQ,CAAC,kBAAkB,EAAE,MAAM,CAAC;IACpC,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;CACpC;AAED,uEAAuE;AACvE,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;IACnC,QAAQ,CAAC,kBAAkB,EAAE,MAAM,CAAC;IACpC,QAAQ,CAAC,qBAAqB,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9C,QAAQ,CAAC,oBAAoB,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7C,QAAQ,CAAC,oBAAoB,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7C,QAAQ,CAAC,sBAAsB,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/C,QAAQ,CAAC,mBAAmB,EAAE,MAAM,GAAG,IAAI,CAAC;CAC7C;AAED,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,gBAAgB,GAAG,OAAO,CAEvE;AAED,wBAAgB,yBAAyB,CACvC,OAAO,EAAE,SAAS,gBAAgB,EAAE,GACnC,SAAS,gBAAgB,EAAE,CAE7B;AAED,qEAAqE;AACrE,wBAAgB,0BAA0B,CACxC,MAAM,EAAE,gBAAgB,GACvB,wBAAwB,CAY1B;AAoBD,iFAAiF;AACjF,wBAAgB,wBAAwB,CACtC,MAAM,EAAE,gBAAgB,EACxB,QAAQ,CAAC,EAAE,qBAAqB,GAC/B,sBAAsB,CAiBxB;AAED,wBAAgB,6BAA6B,CAC3C,OAAO,EAAE,SAAS,gBAAgB,EAAE,GACnC,MAAM,CAIR;AAED,wBAAgB,2BAA2B,CACzC,OAAO,EAAE,SAAS,gBAAgB,EAAE,EACpC,mBAAmB,CAAC,EAAE,WAAW,CAAC,MAAM,EAAE,qBAAqB,CAAC,GAC/D,MAAM,CAOR;AAED,uDAAuD;AACvD,wBAAgB,0BAA0B,CACxC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC7B,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAMzB"}

package/dist/infra/telemetry.js

@@ -0,0 +1,100 @@
+/**
+ * Privacy-safe community telemetry export (SP-082).
+ *
+ * Maps routing telemetry rows to anonymized community export shapes and
+ * HyDRA calibration batches. Never exports prompt text, messages, request_id,
+ * or raw session_id — session identifiers are one-way hashed only.
+ */
+import { createHash } from 'node:crypto';
+export const COMMUNITY_TELEMETRY_ENABLED_ENV = 'SMART_ROUTER_COMMUNITY_TELEMETRY';
+export const COMMUNITY_TELEMETRY_ENABLED_NOTIFY_MESSAGE = 'Smart Router community telemetry export is enabled. Only anonymized routing metadata is exported — no prompt text, messages, or raw session identifiers.';
+export const TELEMETRY_EXPORT_FORBIDDEN_KEYS = [
+    'session_id',
+    'request_id',
+    'prompt_text',
+    'messages',
+    'prompt',
+    'pepper',
+    'install_pepper',
+    'dataset_pepper',
+    'dataset_key',
+    'prompt_fingerprint',
+];
+export const HYDRA_CALIBRATION_STAGE = 'hydra_match';
+export function isCommunityTelemetryExportEnabled() {
+    return process.env[COMMUNITY_TELEMETRY_ENABLED_ENV] === '1';
+}
+/** One-way hash for session correlation without exporting raw session_id. */
+export function hashSessionIdForTelemetryExport(sessionId) {
+    return createHash('sha256').update(sessionId).digest('hex');
+}
+export function isHydraMatchTelemetry(record) {
+    return record.stage === HYDRA_CALIBRATION_STAGE;
+}
+export function selectHydraMatchTelemetry(records) {
+    return records.filter(isHydraMatchTelemetry);
+}
+/** Map a telemetry row to a privacy-safe community export object. */
+export function toCommunityTelemetryRecord(record) {
+    return {
+        timestamp: record.timestamp,
+        session_id_hash: hashSessionIdForTelemetryExport(record.session_id),
+        turn_type: record.turn_type,
+        stage: record.stage,
+        reason_code: record.reason_code,
+        selected_model_id: record.selected_model_id,
+        estimated_cost_usd: record.estimated_cost_usd,
+        routing_latency_ms: record.routing_latency_ms,
+        pin_reason: record.pin_reason,
+    };
+}
+function topViableCandidate(features) {
+    const candidates = features?.candidates;
+    if (!candidates || candidates.length === 0) {
+        return { model_id: null, score: null };
+    }
+    const viable = candidates.filter((candidate) => candidate.rejected_reason === null);
+    const pool = viable.length > 0 ? viable : [...candidates];
+    const best = pool.reduce((leading, candidate) => candidate.score > leading.score ? candidate : leading);
+    return { model_id: best.model_id, score: best.score };
+}
+/** Map a hydra_match telemetry row to a collaborative calibration export row. */
+export function toHydraCalibrationRecord(record, features) {
+    const requirements = features?.requirements ?? null;
+    const top = topViableCandidate(features);
+    return {
+        timestamp: record.timestamp,
+        session_id_hash: hashSessionIdForTelemetryExport(record.session_id),
+        turn_type: record.turn_type,
+        reason_code: record.reason_code,
+        selected_model_id: record.selected_model_id,
+        routing_latency_ms: record.routing_latency_ms,
+        requirement_reasoning: requirements?.reasoning ?? null,
+        requirement_code_gen: requirements?.code_gen ?? null,
+        requirement_tool_use: requirements?.tool_use ?? null,
+        top_candidate_model_id: top.model_id,
+        top_candidate_score: top.score,
+    };
+}
+export function formatCommunityTelemetryJsonl(records) {
+    return records
+        .map((record) => JSON.stringify(toCommunityTelemetryRecord(record)))
+        .join('\n');
+}
+export function formatHydraCalibrationJsonl(records, featuresByRequestId) {
+    return selectHydraMatchTelemetry(records)
+        .map((record) => {
+        const features = featuresByRequestId?.get(record.request_id);
+        return JSON.stringify(toHydraCalibrationRecord(record, features));
+    })
+        .join('\n');
+}
+/** Defense-in-depth scrub for loose export objects. */
+export function scrubTelemetryExportObject(value) {
+    const scrubbed = { ...value };
+    for (const key of TELEMETRY_EXPORT_FORBIDDEN_KEYS) {
+        delete scrubbed[key];
+    }
+    return scrubbed;
+}
+//# sourceMappingURL=telemetry.js.map

package/dist/infra/telemetry.js.map

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

package/dist/infrastructure/delegation/provider-error.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Parse provider error payloads from pi-ai assistant errorMessage strings.
+ */
+import type { AssistantMessage } from '@earendil-works/pi-ai/compat';
+import { formatGeminiThoughtSignatureErrorMessage, isGeminiThoughtSignatureAssistantError, isGeminiThoughtSignatureError } from '../../infra/gemini-provider.js';
+export { formatGeminiThoughtSignatureErrorMessage, isGeminiThoughtSignatureAssistantError, isGeminiThoughtSignatureError, };
+export interface ParsedProviderError {
+    readonly statusCode?: number;
+    readonly code?: string;
+    readonly message?: string;
+}
+/**
+ * Extract HTTP status / error code from JSON provider error blobs.
+ */
+export declare function parseProviderError(errorMessage: string): ParsedProviderError | undefined;
+export declare function parseAssistantMessageError(message: AssistantMessage): ParsedProviderError | undefined;
+export declare function isInfraAssistantError(message: AssistantMessage): boolean;
+/** Output tokens at or below this count are treated as no usable generation. */
+export declare const NEGLIGIBLE_OUTPUT_TOKEN_MAX = 4;
+/** Input ratio of context window that signals context pressure on length stops. */
+export declare const LENGTH_STOP_CONTEXT_PRESSURE_RATIO = 0.99;
+export type LengthStopKind = 'context_pressure' | 'output_truncation';
+export interface LengthStopHints {
+    readonly contextWindow?: number;
+}
+export declare function isNegligibleOutputTokens(outputTokens: number): boolean;
+/**
+ * Classify a `stopReason: length` assistant message as context pressure vs output truncation.
+ */
+export declare function classifyLengthStop(message: AssistantMessage, hints?: LengthStopHints): LengthStopKind | undefined;
+/**
+ * User-facing text for length stops — distinct wording for context pressure vs truncation.
+ */
+export declare function formatLengthStopMessage(message: AssistantMessage, hints?: LengthStopHints): string;
+/**
+ * Rewrite context-pressure length stops as errors so pi surfaces the overflow message.
+ */
+export declare function sanitizeLengthStopMessage(message: AssistantMessage, hints?: LengthStopHints): AssistantMessage;
+/**
+ * Format a provider error blob for user-facing display (terminal/session).
+ * Never returns raw nested JSON.
+ */
+export declare function formatProviderErrorMessage(errorMessage: string): string;
+//# sourceMappingURL=provider-error.d.ts.map

package/dist/infrastructure/delegation/provider-error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider-error.d.ts","sourceRoot":"","sources":["../../../src/infrastructure/delegation/provider-error.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AAGrE,OAAO,EACL,wCAAwC,EACxC,sCAAsC,EACtC,6BAA6B,EAC9B,MAAM,gCAAgC,CAAC;AAGxC,OAAO,EACL,wCAAwC,EACxC,sCAAsC,EACtC,6BAA6B,GAC9B,CAAC;AAEF,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;CAC3B;AAYD;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,YAAY,EAAE,MAAM,GAAG,mBAAmB,GAAG,SAAS,CAgExF;AAED,wBAAgB,0BAA0B,CACxC,OAAO,EAAE,gBAAgB,GACxB,mBAAmB,GAAG,SAAS,CAKjC;AAED,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAMxE;AAID,gFAAgF;AAChF,eAAO,MAAM,2BAA2B,IAAI,CAAC;AAE7C,mFAAmF;AACnF,eAAO,MAAM,kCAAkC,OAAO,CAAC;AAEvD,MAAM,MAAM,cAAc,GAAG,kBAAkB,GAAG,mBAAmB,CAAC;AAEtE,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;CACjC;AAED,wBAAgB,wBAAwB,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAEtE;AAMD;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,gBAAgB,EACzB,KAAK,CAAC,EAAE,eAAe,GACtB,cAAc,GAAG,SAAS,CAsB5B;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,gBAAgB,EACzB,KAAK,CAAC,EAAE,eAAe,GACtB,MAAM,CAkBR;AAED;;GAEG;AACH,wBAAgB,yBAAyB,CACvC,OAAO,EAAE,gBAAgB,EACzB,KAAK,CAAC,EAAE,eAAe,GACtB,gBAAgB,CAUlB;AAED;;;GAGG;AACH,wBAAgB,0BAA0B,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,CA2BvE"}

package/dist/infrastructure/delegation/provider-error.js

@@ -0,0 +1,179 @@
+/**
+ * Parse provider error payloads from pi-ai assistant errorMessage strings.
+ */
+import { isContextOverflow } from '@earendil-works/pi-ai';
+import { formatGeminiThoughtSignatureErrorMessage, isGeminiThoughtSignatureAssistantError, isGeminiThoughtSignatureError, } from '../../infra/gemini-provider.js';
+import { isInfraError } from '../gateway/circuit-breaker.js';
+export { formatGeminiThoughtSignatureErrorMessage, isGeminiThoughtSignatureAssistantError, isGeminiThoughtSignatureError, };
+function parseNumericCode(value) {
+    if (typeof value === 'number' && Number.isFinite(value)) {
+        return value;
+    }
+    if (typeof value === 'string' && /^\d+$/.test(value)) {
+        return Number.parseInt(value, 10);
+    }
+    return undefined;
+}
+/**
+ * Extract HTTP status / error code from JSON provider error blobs.
+ */
+export function parseProviderError(errorMessage) {
+    const trimmed = errorMessage.trim();
+    if (!trimmed.startsWith('{')) {
+        const statusMatch = trimmed.match(/\b(429|5\d{2})\b/);
+        if (statusMatch) {
+            return { statusCode: Number.parseInt(statusMatch[1], 10) };
+        }
+        return undefined;
+    }
+    try {
+        const parsed = JSON.parse(trimmed);
+        const nested = parsed.error;
+        const statusCode = parseNumericCode(nested?.code) ??
+            parseNumericCode(nested?.status) ??
+            parseNumericCode(parsed.code) ??
+            parseNumericCode(parsed.status);
+        const code = typeof nested?.status === 'string'
+            ? nested.status
+            : typeof parsed.status === 'string'
+                ? parsed.status
+                : undefined;
+        let message = typeof nested?.message === 'string'
+            ? nested.message
+            : typeof parsed.message === 'string'
+                ? parsed.message
+                : undefined;
+        if (message && message.trim().startsWith('{')) {
+            try {
+                const inner = JSON.parse(message);
+                if (typeof inner.error?.message === 'string') {
+                    message = inner.error.message;
+                }
+                else if (typeof inner.message === 'string') {
+                    message = inner.message;
+                }
+            }
+            catch {
+                // Nested provider error payloads may be malformed JSON — keep outer message.
+            }
+        }
+        if (statusCode === undefined && code === undefined && message === undefined) {
+            return undefined;
+        }
+        return {
+            ...(statusCode !== undefined ? { statusCode } : {}),
+            ...(code ? { code } : {}),
+            ...(message ? { message } : {}),
+        };
+    }
+    catch {
+        return undefined;
+    }
+}
+export function parseAssistantMessageError(message) {
+    if (message.stopReason !== 'error' || !message.errorMessage) {
+        return undefined;
+    }
+    return parseProviderError(message.errorMessage);
+}
+export function isInfraAssistantError(message) {
+    const parsed = parseAssistantMessageError(message);
+    if (!parsed) {
+        return false;
+    }
+    return isInfraError(parsed);
+}
+const FORMATTED_ERROR_MAX_LENGTH = 200;
+/** Output tokens at or below this count are treated as no usable generation. */
+export const NEGLIGIBLE_OUTPUT_TOKEN_MAX = 4;
+/** Input ratio of context window that signals context pressure on length stops. */
+export const LENGTH_STOP_CONTEXT_PRESSURE_RATIO = 0.99;
+export function isNegligibleOutputTokens(outputTokens) {
+    return outputTokens <= NEGLIGIBLE_OUTPUT_TOKEN_MAX;
+}
+function inputTokensUsed(message) {
+    return message.usage.input + message.usage.cacheRead;
+}
+/**
+ * Classify a `stopReason: length` assistant message as context pressure vs output truncation.
+ */
+export function classifyLengthStop(message, hints) {
+    if (message.stopReason !== 'length') {
+        return undefined;
+    }
+    if (!isNegligibleOutputTokens(message.usage.output)) {
+        return 'output_truncation';
+    }
+    const contextWindow = hints?.contextWindow;
+    if (contextWindow !== undefined) {
+        if (isContextOverflow(message, contextWindow)) {
+            return 'context_pressure';
+        }
+        const inputTokens = inputTokensUsed(message);
+        if (inputTokens >= contextWindow * LENGTH_STOP_CONTEXT_PRESSURE_RATIO) {
+            return 'context_pressure';
+        }
+    }
+    return 'output_truncation';
+}
+/**
+ * User-facing text for length stops — distinct wording for context pressure vs truncation.
+ */
+export function formatLengthStopMessage(message, hints) {
+    const kind = classifyLengthStop(message, hints);
+    if (kind === 'context_pressure') {
+        const inputTokens = inputTokensUsed(message);
+        const limitSuffix = hints?.contextWindow !== undefined
+            ? ` (context limit: ${hints.contextWindow.toLocaleString()} tokens)`
+            : '';
+        return (`Context window exceeded: ${inputTokens.toLocaleString()} input tokens used${limitSuffix}, ` +
+            'leaving no room for output. Try compacting history or switching to a larger-context model.');
+    }
+    return ('Model stopped because it reached the maximum output token limit. ' +
+        'The response may be incomplete.');
+}
+/**
+ * Rewrite context-pressure length stops as errors so pi surfaces the overflow message.
+ */
+export function sanitizeLengthStopMessage(message, hints) {
+    if (classifyLengthStop(message, hints) !== 'context_pressure') {
+        return message;
+    }
+    return {
+        ...message,
+        stopReason: 'error',
+        errorMessage: formatLengthStopMessage(message, hints),
+    };
+}
+/**
+ * Format a provider error blob for user-facing display (terminal/session).
+ * Never returns raw nested JSON.
+ */
+export function formatProviderErrorMessage(errorMessage) {
+    const parsed = parseProviderError(errorMessage);
+    if (parsed) {
+        const prefixParts = [];
+        if (parsed.statusCode !== undefined) {
+            prefixParts.push(String(parsed.statusCode));
+        }
+        if (parsed.code) {
+            prefixParts.push(parsed.code);
+        }
+        const prefix = prefixParts.length > 0 ? `${prefixParts.join(' ')}: ` : '';
+        if (parsed.message) {
+            return `${prefix}${parsed.message}`;
+        }
+        if (prefixParts.length > 0) {
+            return `Provider error (${prefixParts.join(' ')})`;
+        }
+    }
+    const trimmed = errorMessage.trim();
+    if (trimmed.startsWith('{')) {
+        return 'Provider error (unparseable response)';
+    }
+    if (trimmed.length > FORMATTED_ERROR_MAX_LENGTH) {
+        return `${trimmed.slice(0, FORMATTED_ERROR_MAX_LENGTH)}…`;
+    }
+    return trimmed;
+}
+//# sourceMappingURL=provider-error.js.map

package/dist/infrastructure/delegation/provider-error.js.map

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