@crewhaus/ir 0.2.0 → 0.2.2

package/dist/index.d.ts

@@ -118,6 +118,45 @@ export type IrModelTiers = {
         readonly priorToolDensityThreshold?: number;
     };
 };
+/** One declared candidate in a `model_pool`. */
+export type IrModelPoolCandidate = {
+    readonly model: string;
+    readonly tags: readonly string[];
+};
+/**
+ * Adaptive model routing — the N-candidate `model_pool` with a per-turn
+ * selection `policy` (`static` | `heuristic` | `learned`). Carried on the
+ * agent blocks of the routing-capable shapes (cli, channel, managed), mutually
+ * exclusive with `modelTiers`/`modelFallbacks` (enforced in the spec). Absent
+ * when the spec omits `model_pool` — codegen gates on presence so an unset
+ * block leaves bundles byte-identical. `policy` and each candidate's `tags` are
+ * always present (spec defaults them); every other knob is carried verbatim.
+ */
+export type IrModelPool = {
+    readonly candidates: readonly IrModelPoolCandidate[];
+    readonly policy: "static" | "heuristic" | "learned";
+    readonly objective?: {
+        readonly quality?: number;
+        readonly cost?: number;
+        readonly latency?: number;
+    };
+    readonly routing?: {
+        readonly contextTokenThreshold?: number;
+        readonly toolsToDefault?: boolean;
+        readonly firstTurnToDefault?: boolean;
+        readonly priorToolDensityThreshold?: number;
+        readonly strongTag?: string;
+        readonly cheapTag?: string;
+    };
+    readonly learning?: {
+        readonly minSamplesPerArm?: number;
+        readonly costRefUsd?: number;
+        readonly latencyRefMs?: number;
+        readonly explorationRate?: number;
+        readonly seed?: string;
+        readonly bandit?: "epsilon-greedy" | "thompson";
+    };
+};
 /**
  * Section 55 (Track A) — named failure taxonomy. Cross-cutting; carried
  * through to runtime-core so `recovery-engine` can consult the user's
@@ -327,6 +366,8 @@ export type IrV0 = {
         readonly circuitBreaker?: IrCircuitBreaker;
         /** Item 26 — two-tier turn-difficulty router. Absent → single-model. */
         readonly modelTiers?: IrModelTiers;
+        /** Adaptive model routing — N-candidate pool. Absent → single-model. */
+        readonly modelPool?: IrModelPool;
     };
     readonly tools: readonly string[];
     readonly toolConfigs: IrToolConfigs;
@@ -587,6 +628,8 @@ export type IrChannelV0 = {
         readonly circuitBreaker?: IrCircuitBreaker;
         /** Item 26 — two-tier turn-difficulty router. Absent → single-model. */
         readonly modelTiers?: IrModelTiers;
+        /** Adaptive model routing — N-candidate pool. Absent → single-model. */
+        readonly modelPool?: IrModelPool;
     };
     readonly tools: readonly string[];
     readonly toolConfigs: IrToolConfigs;
@@ -642,6 +685,8 @@ export type IrManagedV0 = {
         readonly circuitBreaker?: IrCircuitBreaker;
         /** Item 26 — two-tier turn-difficulty router. Absent → single-model. */
         readonly modelTiers?: IrModelTiers;
+        /** Adaptive model routing — N-candidate pool. Absent → single-model. */
+        readonly modelPool?: IrModelPool;
     };
     readonly tenants: readonly IrManagedTenant[];
     readonly permissions: IrPermissions;
@@ -728,6 +773,8 @@ export type IrPipelineV0 = {
     readonly agent: {
         readonly model: string;
         readonly instructions: string;
+        /** Adaptive model routing — N-candidate pool. Absent → single-model. */
+        readonly modelPool?: IrModelPool;
     };
     readonly retrieve: {
         readonly embedderModel: string;
@@ -823,6 +870,8 @@ export type IrResearchV0 = {
     readonly agent: {
         readonly model: string;
         readonly instructions: string;
+        /** Adaptive model routing — N-candidate pool. Absent → single-model. */
+        readonly modelPool?: IrModelPool;
     };
     /** Default research goal. The daemon's `--goal "..."` flag overrides. */
     readonly goal: string;
@@ -868,6 +917,8 @@ export type IrBatchV0 = {
     readonly agent: {
         readonly model: string;
         readonly instructions: string;
+        /** Adaptive model routing — N-candidate pool. Absent → single-model. */
+        readonly modelPool?: IrModelPool;
     };
     readonly queue: {
         readonly adapter: IrBatchQueueAdapter;
@@ -948,6 +999,8 @@ export type IrBrowserV0 = {
     readonly agent: {
         readonly model: string;
         readonly instructions: string;
+        /** Adaptive model routing — N-candidate pool. Absent → single-model. */
+        readonly modelPool?: IrModelPool;
     };
     readonly driver: {
         readonly backend: IrBrowserBackend;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@crewhaus/ir",
-  "version": "0.2.0",
+  "version": "0.2.2",
   "type": "module",
   "description": "Canonical typed intermediate representation",
   "main": "dist/index.js",