pi-smart-router 0.1.0

package/dist/domain/types/schemas.d.ts

@@ -0,0 +1,346 @@
+/**
+ * Zod schemas mirroring JSON-schema contracts and data-model entities.
+ *
+ * Canonical contract sources:
+ *   - specs/001-build-smart-router/contracts/routing-request.schema.json
+ *   - specs/001-build-smart-router/contracts/routing-decision.schema.json
+ *   - specs/001-build-smart-router/data-model.md
+ */
+import { z } from 'zod';
+export declare const TurnTypeSchema: z.ZodEnum<{
+    planning: "planning";
+    tool_result: "tool_result";
+    subagent: "subagent";
+    main_loop: "main_loop";
+    unknown: "unknown";
+}>;
+export declare const PinReasonSchema: z.ZodEnum<{
+    initial: "initial";
+    user_forced: "user_forced";
+    loop_escalation: "loop_escalation";
+    compaction: "compaction";
+    cache_economics: "cache_economics";
+    context_overflow: "context_overflow";
+}>;
+export declare const TierSchema: z.ZodEnum<{
+    "zero-tier": "zero-tier";
+    "economical-cloud": "economical-cloud";
+    "frontier-cloud": "frontier-cloud";
+}>;
+export declare const RoutingStageSchema: z.ZodEnum<{
+    triage: "triage";
+    turn_envelope: "turn_envelope";
+    session_pin: "session_pin";
+    local_zero: "local_zero";
+    hydra_match: "hydra_match";
+    fallback: "fallback";
+}>;
+export declare const PriceSourceSchema: z.ZodEnum<{
+    override: "override";
+    registry: "registry";
+    yaml_fallback: "yaml_fallback";
+}>;
+export declare const MessageRoleSchema: z.ZodEnum<{
+    user: "user";
+    assistant: "assistant";
+    system: "system";
+    tool: "tool";
+}>;
+export declare const MessageSchema: z.ZodObject<{
+    role: z.ZodEnum<{
+        user: "user";
+        assistant: "assistant";
+        system: "system";
+        tool: "tool";
+    }>;
+    content: z.ZodString;
+    tool_call_id: z.ZodOptional<z.ZodString>;
+    tool_calls: z.ZodOptional<z.ZodArray<z.ZodUnknown>>;
+}, z.core.$strip>;
+export declare const RoutingRequestSchema: z.ZodObject<{
+    request_id: z.ZodString;
+    session_id: z.ZodString;
+    prompt_text: z.ZodString;
+    messages: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        role: z.ZodEnum<{
+            user: "user";
+            assistant: "assistant";
+            system: "system";
+            tool: "tool";
+        }>;
+        content: z.ZodString;
+        tool_call_id: z.ZodOptional<z.ZodString>;
+        tool_calls: z.ZodOptional<z.ZodArray<z.ZodUnknown>>;
+    }, z.core.$strip>>>;
+    turn_type: z.ZodOptional<z.ZodEnum<{
+        planning: "planning";
+        tool_result: "tool_result";
+        subagent: "subagent";
+        main_loop: "main_loop";
+        unknown: "unknown";
+    }>>;
+    compaction_flag: z.ZodOptional<z.ZodBoolean>;
+    force_model_id: z.ZodOptional<z.ZodString>;
+    candidate_model_id: z.ZodOptional<z.ZodString>;
+    estimated_input_tokens: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+export declare const SessionPinSchema: z.ZodObject<{
+    session_id: z.ZodString;
+    pinned_model_id: z.ZodString;
+    pin_reason: z.ZodEnum<{
+        initial: "initial";
+        user_forced: "user_forced";
+        loop_escalation: "loop_escalation";
+        compaction: "compaction";
+        cache_economics: "cache_economics";
+        context_overflow: "context_overflow";
+    }>;
+    has_ever_switched: z.ZodBoolean;
+    consecutive_upstream_errors: z.ZodNumber;
+    consecutive_tool_failures: z.ZodNumber;
+    last_tool_failure_signature: z.ZodNullable<z.ZodString>;
+    created_at: z.ZodString;
+    updated_at: z.ZodString;
+}, z.core.$strip>;
+export declare const ModelCapabilitiesSchema: z.ZodObject<{
+    reasoning: z.ZodNumber;
+    code_gen: z.ZodNumber;
+    tool_use: z.ZodNumber;
+}, z.core.$strip>;
+export declare const ModelPerformanceSchema: z.ZodObject<{
+    latency_p50_ms: z.ZodOptional<z.ZodNumber>;
+    verbosity_factor: z.ZodOptional<z.ZodNumber>;
+    cache_friendly: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>;
+export declare const ModelPricingSchema: z.ZodObject<{
+    registry_key: z.ZodOptional<z.ZodString>;
+    fallback_cost_per_1m: z.ZodNumber;
+}, z.core.$strip>;
+export declare const ModelLimitsSchema: z.ZodObject<{
+    max_input_tokens: z.ZodOptional<z.ZodNumber>;
+    max_output_tokens: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+export declare const ModelProfileSchema: z.ZodObject<{
+    id: z.ZodString;
+    tier: z.ZodEnum<{
+        "zero-tier": "zero-tier";
+        "economical-cloud": "economical-cloud";
+        "frontier-cloud": "frontier-cloud";
+    }>;
+    provider: z.ZodString;
+    endpoint: z.ZodOptional<z.ZodString>;
+    capabilities: z.ZodObject<{
+        reasoning: z.ZodNumber;
+        code_gen: z.ZodNumber;
+        tool_use: z.ZodNumber;
+    }, z.core.$strip>;
+    performance: z.ZodOptional<z.ZodObject<{
+        latency_p50_ms: z.ZodOptional<z.ZodNumber>;
+        verbosity_factor: z.ZodOptional<z.ZodNumber>;
+        cache_friendly: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strip>>;
+    pricing: z.ZodObject<{
+        registry_key: z.ZodOptional<z.ZodString>;
+        fallback_cost_per_1m: z.ZodNumber;
+    }, z.core.$strip>;
+    limits: z.ZodOptional<z.ZodObject<{
+        max_input_tokens: z.ZodOptional<z.ZodNumber>;
+        max_output_tokens: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>>;
+    healthy: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>;
+/** Zod-validated model profile — aligned with {@link ModelProfile} in entities.ts. */
+export type ValidatedModelProfile = z.infer<typeof ModelProfileSchema>;
+export declare const CandidateScoreSchema: z.ZodObject<{
+    model_id: z.ZodString;
+    score: z.ZodNumber;
+    shortfall: z.ZodNumber;
+    rejected_reason: z.ZodNullable<z.ZodString>;
+}, z.core.$strip>;
+export declare const RoutingDecisionSchema: z.ZodObject<{
+    request_id: z.ZodString;
+    selected_model_id: z.ZodString;
+    tier: z.ZodEnum<{
+        "zero-tier": "zero-tier";
+        "economical-cloud": "economical-cloud";
+        "frontier-cloud": "frontier-cloud";
+    }>;
+    stage: z.ZodEnum<{
+        triage: "triage";
+        turn_envelope: "turn_envelope";
+        session_pin: "session_pin";
+        local_zero: "local_zero";
+        hydra_match: "hydra_match";
+        fallback: "fallback";
+    }>;
+    reason_code: z.ZodString;
+    candidates: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        model_id: z.ZodString;
+        score: z.ZodNumber;
+        shortfall: z.ZodNumber;
+        rejected_reason: z.ZodNullable<z.ZodString>;
+    }, z.core.$strip>>>;
+    estimated_cost_usd: z.ZodOptional<z.ZodNumber>;
+    routing_latency_ms: z.ZodNumber;
+    pin_reason: z.ZodNullable<z.ZodEnum<{
+        initial: "initial";
+        user_forced: "user_forced";
+        loop_escalation: "loop_escalation";
+        compaction: "compaction";
+        cache_economics: "cache_economics";
+        context_overflow: "context_overflow";
+    }>>;
+}, z.core.$strip>;
+export declare const PriceCatalogSchema: z.ZodObject<{
+    registry_snapshot: z.ZodRecord<z.ZodString, z.ZodNumber>;
+    registry_limits_snapshot: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
+        max_input_tokens: z.ZodOptional<z.ZodNumber>;
+        max_output_tokens: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>>>;
+    user_overrides: z.ZodRecord<z.ZodString, z.ZodNumber>;
+    last_updated: z.ZodString;
+    source: z.ZodEnum<{
+        override: "override";
+        registry: "registry";
+        yaml_fallback: "yaml_fallback";
+    }>;
+}, z.core.$strip>;
+export declare const RoutingTelemetrySchema: z.ZodObject<{
+    timestamp: z.ZodString;
+    session_id: z.ZodString;
+    request_id: z.ZodString;
+    turn_type: z.ZodString;
+    stage: z.ZodString;
+    reason_code: z.ZodString;
+    selected_model_id: z.ZodString;
+    estimated_cost_usd: z.ZodNumber;
+    routing_latency_ms: z.ZodNumber;
+    pin_reason: z.ZodNullable<z.ZodString>;
+}, z.core.$strip>;
+export declare const FrugalityConfigSchema: z.ZodObject<{
+    lambda_cost: z.ZodNumber;
+    lambda_latency: z.ZodNumber;
+    lambda_verbosity: z.ZodNumber;
+}, z.core.$strip>;
+export declare const LoopEscalationConfigSchema: z.ZodObject<{
+    threshold: z.ZodNumber;
+}, z.core.$strip>;
+export declare const PricingConfigSchema: z.ZodObject<{
+    staleness_days: z.ZodNumber;
+}, z.core.$strip>;
+export declare const LocalConfigSchema: z.ZodObject<{
+    min_memory_gb_full: z.ZodNumber;
+    min_memory_gb_classification: z.ZodNumber;
+    battery_threshold_pct: z.ZodNumber;
+}, z.core.$strip>;
+export declare const HydraConfigSchema: z.ZodObject<{
+    artifact_cache_path: z.ZodString;
+}, z.core.$strip>;
+export declare const LowIntensityWeightsSchema: z.ZodObject<{
+    prompt_shortness: z.ZodNumber;
+    token_shortness: z.ZodNumber;
+    cyclomatic_low: z.ZodNumber;
+    trivial_signal: z.ZodNumber;
+    complex_inverse: z.ZodNumber;
+    triage_verdict: z.ZodNumber;
+    turn_type: z.ZodNumber;
+    no_tool_context: z.ZodNumber;
+    message_shallow: z.ZodNumber;
+    prose_ratio: z.ZodNumber;
+    requirement_low: z.ZodNumber;
+    cluster_signal: z.ZodNumber;
+}, z.core.$strip>;
+export declare const LowIntensityConfigSchema: z.ZodObject<{
+    weights: z.ZodObject<{
+        prompt_shortness: z.ZodNumber;
+        token_shortness: z.ZodNumber;
+        cyclomatic_low: z.ZodNumber;
+        trivial_signal: z.ZodNumber;
+        complex_inverse: z.ZodNumber;
+        triage_verdict: z.ZodNumber;
+        turn_type: z.ZodNumber;
+        no_tool_context: z.ZodNumber;
+        message_shallow: z.ZodNumber;
+        prose_ratio: z.ZodNumber;
+        requirement_low: z.ZodNumber;
+        cluster_signal: z.ZodNumber;
+    }, z.core.$strip>;
+    high_threshold: z.ZodNumber;
+    low_threshold: z.ZodNumber;
+    p_success_alpha: z.ZodNumber;
+}, z.core.$strip>;
+export declare const RoutingClustersConfigSchema: z.ZodObject<{
+    config_path: z.ZodString;
+}, z.core.$strip>;
+/** Stable snake_case cluster id — used as reason-code suffix (`cluster_${id}`). */
+export declare const RoutingClusterIdSchema: z.ZodString;
+export declare const RoutingClusterSchema: z.ZodObject<{
+    id: z.ZodString;
+    tier_bias: z.ZodEnum<{
+        "zero-tier": "zero-tier";
+        "economical-cloud": "economical-cloud";
+        "frontier-cloud": "frontier-cloud";
+    }>;
+    reference_prompts: z.ZodArray<z.ZodString>;
+    min_similarity: z.ZodNumber;
+    min_margin: z.ZodNumber;
+}, z.core.$strip>;
+export declare const RoutingClustersFileSchema: z.ZodObject<{
+    clusters: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        tier_bias: z.ZodEnum<{
+            "zero-tier": "zero-tier";
+            "economical-cloud": "economical-cloud";
+            "frontier-cloud": "frontier-cloud";
+        }>;
+        reference_prompts: z.ZodArray<z.ZodString>;
+        min_similarity: z.ZodNumber;
+        min_margin: z.ZodNumber;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export declare const OperatorConfigSchema: z.ZodObject<{
+    frugality: z.ZodObject<{
+        lambda_cost: z.ZodNumber;
+        lambda_latency: z.ZodNumber;
+        lambda_verbosity: z.ZodNumber;
+    }, z.core.$strip>;
+    loop_escalation: z.ZodObject<{
+        threshold: z.ZodNumber;
+    }, z.core.$strip>;
+    pricing: z.ZodObject<{
+        staleness_days: z.ZodNumber;
+    }, z.core.$strip>;
+    local: z.ZodObject<{
+        min_memory_gb_full: z.ZodNumber;
+        min_memory_gb_classification: z.ZodNumber;
+        battery_threshold_pct: z.ZodNumber;
+    }, z.core.$strip>;
+    hydra: z.ZodObject<{
+        artifact_cache_path: z.ZodString;
+    }, z.core.$strip>;
+    low_intensity: z.ZodObject<{
+        weights: z.ZodObject<{
+            prompt_shortness: z.ZodNumber;
+            token_shortness: z.ZodNumber;
+            cyclomatic_low: z.ZodNumber;
+            trivial_signal: z.ZodNumber;
+            complex_inverse: z.ZodNumber;
+            triage_verdict: z.ZodNumber;
+            turn_type: z.ZodNumber;
+            no_tool_context: z.ZodNumber;
+            message_shallow: z.ZodNumber;
+            prose_ratio: z.ZodNumber;
+            requirement_low: z.ZodNumber;
+            cluster_signal: z.ZodNumber;
+        }, z.core.$strip>;
+        high_threshold: z.ZodNumber;
+        low_threshold: z.ZodNumber;
+        p_success_alpha: z.ZodNumber;
+    }, z.core.$strip>;
+    routing_clusters: z.ZodOptional<z.ZodObject<{
+        config_path: z.ZodString;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type OperatorConfig = z.infer<typeof OperatorConfigSchema>;
+export type LowIntensityConfig = z.infer<typeof LowIntensityConfigSchema>;
+//# sourceMappingURL=schemas.d.ts.map

package/dist/domain/types/schemas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schemas.d.ts","sourceRoot":"","sources":["../../../src/domain/types/schemas.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,eAAO,MAAM,cAAc;;;;;;EAMzB,CAAC;AAEH,eAAO,MAAM,eAAe;;;;;;;EAO1B,CAAC;AAEH,eAAO,MAAM,UAAU;;;;EAIrB,CAAC;AAEH,eAAO,MAAM,kBAAkB;;;;;;;EAO7B,CAAC;AAEH,eAAO,MAAM,iBAAiB;;;;EAI5B,CAAC;AAEH,eAAO,MAAM,iBAAiB;;;;;EAK5B,CAAC;AAIH,eAAO,MAAM,aAAa;;;;;;;;;;iBAKxB,CAAC;AAIH,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;iBAU/B,CAAC;AAIH,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;iBAU3B,CAAC;AAIH,eAAO,MAAM,uBAAuB;;;;iBAIlC,CAAC;AAEH,eAAO,MAAM,sBAAsB;;;;iBAIjC,CAAC;AAEH,eAAO,MAAM,kBAAkB;;;iBAG7B,CAAC;AAEH,eAAO,MAAM,iBAAiB;;;iBAG5B,CAAC;AAEH,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAU7B,CAAC;AAEH,sFAAsF;AACtF,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAIvE,eAAO,MAAM,oBAAoB;;;;;iBAK/B,CAAC;AAIH,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAUhC,CAAC;AAIH,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;iBAM7B,CAAC;AAIH,eAAO,MAAM,sBAAsB;;;;;;;;;;;iBAWjC,CAAC;AAIH,eAAO,MAAM,qBAAqB;;;;iBAIhC,CAAC;AAEH,eAAO,MAAM,0BAA0B;;iBAErC,CAAC;AAEH,eAAO,MAAM,mBAAmB;;iBAE9B,CAAC;AAEH,eAAO,MAAM,iBAAiB;;;;iBAI5B,CAAC;AAEH,eAAO,MAAM,iBAAiB;;iBAE5B,CAAC;AAEH,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;iBAapC,CAAC;AAEH,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;;;;iBAcnC,CAAC;AAEH,eAAO,MAAM,2BAA2B;;iBAEtC,CAAC;AAEH,mFAAmF;AACnF,eAAO,MAAM,sBAAsB,aAGqC,CAAC;AAEzE,eAAO,MAAM,oBAAoB;;;;;;;;;;iBAM/B,CAAC;AAEH,eAAO,MAAM,yBAAyB;;;;;;;;;;;;iBAgBlC,CAAC;AAEL,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAQ/B,CAAC;AAIH,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAClE,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC"}

package/dist/domain/types/schemas.js

@@ -0,0 +1,241 @@
+/**
+ * Zod schemas mirroring JSON-schema contracts and data-model entities.
+ *
+ * Canonical contract sources:
+ *   - specs/001-build-smart-router/contracts/routing-request.schema.json
+ *   - specs/001-build-smart-router/contracts/routing-decision.schema.json
+ *   - specs/001-build-smart-router/data-model.md
+ */
+import { z } from 'zod';
+// ─── Enum schemas ────────────────────────────────────────────────────────────
+export const TurnTypeSchema = z.enum([
+    'planning',
+    'tool_result',
+    'subagent',
+    'main_loop',
+    'unknown',
+]);
+export const PinReasonSchema = z.enum([
+    'initial',
+    'user_forced',
+    'loop_escalation',
+    'compaction',
+    'cache_economics',
+    'context_overflow',
+]);
+export const TierSchema = z.enum([
+    'zero-tier',
+    'economical-cloud',
+    'frontier-cloud',
+]);
+export const RoutingStageSchema = z.enum([
+    'triage',
+    'turn_envelope',
+    'session_pin',
+    'local_zero',
+    'hydra_match',
+    'fallback',
+]);
+export const PriceSourceSchema = z.enum([
+    'override',
+    'registry',
+    'yaml_fallback',
+]);
+export const MessageRoleSchema = z.enum([
+    'user',
+    'assistant',
+    'system',
+    'tool',
+]);
+// ─── Message (contract: routing-request.schema.json) ─────────────────────────
+export const MessageSchema = z.object({
+    role: MessageRoleSchema,
+    content: z.string(),
+    tool_call_id: z.string().optional(),
+    tool_calls: z.array(z.unknown()).optional(),
+});
+// ─── RoutingRequest (contract: routing-request.schema.json) ──────────────────
+export const RoutingRequestSchema = z.object({
+    request_id: z.string().uuid(),
+    session_id: z.string().min(1),
+    prompt_text: z.string(),
+    messages: z.array(MessageSchema).optional(),
+    turn_type: TurnTypeSchema.optional(),
+    compaction_flag: z.boolean().optional(),
+    force_model_id: z.string().optional(),
+    candidate_model_id: z.string().optional(),
+    estimated_input_tokens: z.number().int().nonnegative().optional(),
+});
+// ─── SessionPin (data-model.md) ──────────────────────────────────────────────
+export const SessionPinSchema = z.object({
+    session_id: z.string(),
+    pinned_model_id: z.string(),
+    pin_reason: PinReasonSchema,
+    has_ever_switched: z.boolean(),
+    consecutive_upstream_errors: z.number().int().nonnegative(),
+    consecutive_tool_failures: z.number().int().nonnegative(),
+    last_tool_failure_signature: z.string().nullable(),
+    created_at: z.string().datetime(),
+    updated_at: z.string().datetime(),
+});
+// ─── ModelProfile (data-model.md) ────────────────────────────────────────────
+export const ModelCapabilitiesSchema = z.object({
+    reasoning: z.number().min(0).max(1),
+    code_gen: z.number().min(0).max(1),
+    tool_use: z.number().min(0).max(1),
+});
+export const ModelPerformanceSchema = z.object({
+    latency_p50_ms: z.number().optional(),
+    verbosity_factor: z.number().optional(),
+    cache_friendly: z.boolean().optional(),
+});
+export const ModelPricingSchema = z.object({
+    registry_key: z.string().optional(),
+    fallback_cost_per_1m: z.number(),
+});
+export const ModelLimitsSchema = z.object({
+    max_input_tokens: z.number().int().positive().optional(),
+    max_output_tokens: z.number().int().positive().optional(),
+});
+export const ModelProfileSchema = z.object({
+    id: z.string(),
+    tier: TierSchema,
+    provider: z.string(),
+    endpoint: z.string().optional(),
+    capabilities: ModelCapabilitiesSchema,
+    performance: ModelPerformanceSchema.optional(),
+    pricing: ModelPricingSchema,
+    limits: ModelLimitsSchema.optional(),
+    healthy: z.boolean().optional(),
+});
+// ─── CandidateScore (contract: routing-decision.schema.json) ─────────────────
+export const CandidateScoreSchema = z.object({
+    model_id: z.string(),
+    score: z.number(),
+    shortfall: z.number(),
+    rejected_reason: z.string().nullable(),
+});
+// ─── RoutingDecision (contract: routing-decision.schema.json) ────────────────
+export const RoutingDecisionSchema = z.object({
+    request_id: z.string().uuid(),
+    selected_model_id: z.string(),
+    tier: TierSchema,
+    stage: RoutingStageSchema,
+    reason_code: z.string(),
+    candidates: z.array(CandidateScoreSchema).optional(),
+    estimated_cost_usd: z.number().nonnegative().optional(),
+    routing_latency_ms: z.number().nonnegative(),
+    pin_reason: PinReasonSchema.nullable(),
+});
+// ─── PriceCatalog (data-model.md) ────────────────────────────────────────────
+export const PriceCatalogSchema = z.object({
+    registry_snapshot: z.record(z.string(), z.number()),
+    registry_limits_snapshot: z.record(z.string(), ModelLimitsSchema).optional(),
+    user_overrides: z.record(z.string(), z.number()),
+    last_updated: z.string().datetime(),
+    source: PriceSourceSchema,
+});
+// ─── RoutingTelemetry (data-model.md) ────────────────────────────────────────
+export const RoutingTelemetrySchema = z.object({
+    timestamp: z.string().datetime(),
+    session_id: z.string(),
+    request_id: z.string(),
+    turn_type: z.string(),
+    stage: z.string(),
+    reason_code: z.string(),
+    selected_model_id: z.string(),
+    estimated_cost_usd: z.number(),
+    routing_latency_ms: z.number(),
+    pin_reason: z.string().nullable(),
+});
+// ─── Operator configuration schema (data-model.md § Configuration) ───────────
+export const FrugalityConfigSchema = z.object({
+    lambda_cost: z.number().min(0).max(1),
+    lambda_latency: z.number().min(0),
+    lambda_verbosity: z.number().min(0),
+});
+export const LoopEscalationConfigSchema = z.object({
+    threshold: z.number().int().positive(),
+});
+export const PricingConfigSchema = z.object({
+    staleness_days: z.number().int().positive(),
+});
+export const LocalConfigSchema = z.object({
+    min_memory_gb_full: z.number().positive(),
+    min_memory_gb_classification: z.number().positive(),
+    battery_threshold_pct: z.number().min(0).max(100),
+});
+export const HydraConfigSchema = z.object({
+    artifact_cache_path: z.string(),
+});
+export const LowIntensityWeightsSchema = z.object({
+    prompt_shortness: z.number().min(0),
+    token_shortness: z.number().min(0),
+    cyclomatic_low: z.number().min(0),
+    trivial_signal: z.number().min(0),
+    complex_inverse: z.number().min(0),
+    triage_verdict: z.number().min(0),
+    turn_type: z.number().min(0),
+    no_tool_context: z.number().min(0),
+    message_shallow: z.number().min(0),
+    prose_ratio: z.number().min(0),
+    requirement_low: z.number().min(0),
+    cluster_signal: z.number().min(0),
+});
+export const LowIntensityConfigSchema = z.object({
+    weights: LowIntensityWeightsSchema,
+    high_threshold: z.number().min(0).max(1),
+    low_threshold: z.number().min(0).max(1),
+    /** Minimum P_success_cheap to bias toward economical/local tier (SP-105). */
+    p_success_alpha: z.number().min(0).max(1),
+}).superRefine((value, ctx) => {
+    if (value.high_threshold <= value.low_threshold) {
+        ctx.addIssue({
+            code: z.ZodIssueCode.custom,
+            message: 'high_threshold must be greater than low_threshold',
+            path: ['high_threshold'],
+        });
+    }
+});
+export const RoutingClustersConfigSchema = z.object({
+    config_path: z.string().min(1),
+});
+/** Stable snake_case cluster id — used as reason-code suffix (`cluster_${id}`). */
+export const RoutingClusterIdSchema = z
+    .string()
+    .min(1)
+    .regex(/^[a-z][a-z0-9_]*$/, 'Cluster id must be lowercase snake_case');
+export const RoutingClusterSchema = z.object({
+    id: RoutingClusterIdSchema,
+    tier_bias: TierSchema,
+    reference_prompts: z.array(z.string().min(1)).min(1),
+    min_similarity: z.number().min(0).max(1),
+    min_margin: z.number().min(0).max(1),
+});
+export const RoutingClustersFileSchema = z
+    .object({
+    clusters: z.array(RoutingClusterSchema).min(1),
+})
+    .superRefine((value, ctx) => {
+    const seen = new Set();
+    for (const [index, cluster] of value.clusters.entries()) {
+        if (seen.has(cluster.id)) {
+            ctx.addIssue({
+                code: z.ZodIssueCode.custom,
+                message: `Duplicate cluster id: ${cluster.id}`,
+                path: ['clusters', index, 'id'],
+            });
+        }
+        seen.add(cluster.id);
+    }
+});
+export const OperatorConfigSchema = z.object({
+    frugality: FrugalityConfigSchema,
+    loop_escalation: LoopEscalationConfigSchema,
+    pricing: PricingConfigSchema,
+    local: LocalConfigSchema,
+    hydra: HydraConfigSchema,
+    low_intensity: LowIntensityConfigSchema,
+    routing_clusters: RoutingClustersConfigSchema.optional(),
+});
+//# sourceMappingURL=schemas.js.map

package/dist/domain/types/schemas.js.map

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

package/dist/domain/types/store-port.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Persistence port for routing state.
+ * Implementations live in infrastructure/ (SQLite, in-memory for tests).
+ */
+import type { ModelProfile, PriceCatalog, RoutingDatasetRecord, RoutingOutcomeRecord, RoutingTelemetry, SessionPin } from './entities.js';
+export interface ListTelemetryOptions {
+    readonly limit?: number;
+    readonly sessionId?: string;
+}
+export interface ListDatasetOptions {
+    readonly limit?: number;
+}
+export interface ListOutcomeOptions {
+    readonly limit?: number;
+    readonly requestId?: string;
+    readonly sessionId?: string;
+}
+export interface StorePort {
+    /** Retrieve an active session pin, or null if unpinned. */
+    getSessionPin(sessionId: string): Promise<SessionPin | null>;
+    /** Upsert a session pin (create or replace). */
+    putSessionPin(pin: SessionPin): Promise<void>;
+    /** Delete a session pin (e.g. on explicit unpin). */
+    deleteSessionPin(sessionId: string): Promise<void>;
+    /** Load the full model fleet catalog. */
+    getModelProfiles(): Promise<readonly ModelProfile[]>;
+    /** Load the current price catalog. */
+    getPriceCatalog(): Promise<PriceCatalog | null>;
+    /** Persist an updated price catalog. */
+    putPriceCatalog(catalog: PriceCatalog): Promise<void>;
+    /** Append a routing telemetry audit record (sync hot path). */
+    appendTelemetry(entry: RoutingTelemetry): void;
+    /** List recent telemetry rows, newest first. */
+    listTelemetry(options?: ListTelemetryOptions): Promise<readonly RoutingTelemetry[]>;
+    /** Append a privacy-safe routing dataset record (sync hot path). */
+    appendDatasetRecord(entry: RoutingDatasetRecord): void;
+    /** List recent dataset rows, newest first. */
+    listDatasetRecords(options?: ListDatasetOptions): Promise<readonly RoutingDatasetRecord[]>;
+    /** Append a behavioral outcome label (sync hot path). */
+    appendOutcomeRecord(entry: RoutingOutcomeRecord): void;
+    /** List recent outcome rows, newest first. */
+    listOutcomeRecords(options?: ListOutcomeOptions): Promise<readonly RoutingOutcomeRecord[]>;
+}
+//# sourceMappingURL=store-port.d.ts.map

package/dist/domain/types/store-port.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"store-port.d.ts","sourceRoot":"","sources":["../../../src/domain/types/store-port.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,YAAY,EAAE,oBAAoB,EAAE,oBAAoB,EAAE,gBAAgB,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAE1I,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED,MAAM,WAAW,SAAS;IACxB,2DAA2D;IAC3D,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,CAAC;IAE7D,gDAAgD;IAChD,aAAa,CAAC,GAAG,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE9C,qDAAqD;IACrD,gBAAgB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEnD,yCAAyC;IACzC,gBAAgB,IAAI,OAAO,CAAC,SAAS,YAAY,EAAE,CAAC,CAAC;IAErD,sCAAsC;IACtC,eAAe,IAAI,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC,CAAC;IAEhD,wCAAwC;IACxC,eAAe,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEtD,+DAA+D;IAC/D,eAAe,CAAC,KAAK,EAAE,gBAAgB,GAAG,IAAI,CAAC;IAE/C,gDAAgD;IAChD,aAAa,CAAC,OAAO,CAAC,EAAE,oBAAoB,GAAG,OAAO,CAAC,SAAS,gBAAgB,EAAE,CAAC,CAAC;IAEpF,oEAAoE;IACpE,mBAAmB,CAAC,KAAK,EAAE,oBAAoB,GAAG,IAAI,CAAC;IAEvD,8CAA8C;IAC9C,kBAAkB,CAAC,OAAO,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,SAAS,oBAAoB,EAAE,CAAC,CAAC;IAE3F,yDAAyD;IACzD,mBAAmB,CAAC,KAAK,EAAE,oBAAoB,GAAG,IAAI,CAAC;IAEvD,8CAA8C;IAC9C,kBAAkB,CAAC,OAAO,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,SAAS,oBAAoB,EAAE,CAAC,CAAC;CAC5F"}

package/dist/domain/types/store-port.js

@@ -0,0 +1,6 @@
+/**
+ * Persistence port for routing state.
+ * Implementations live in infrastructure/ (SQLite, in-memory for tests).
+ */
+export {};
+//# sourceMappingURL=store-port.js.map

package/dist/domain/types/store-port.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"store-port.js","sourceRoot":"","sources":["../../../src/domain/types/store-port.ts"],"names":[],"mappings":"AAAA;;;GAGG"}