@duetso/agent 0.2.2 → 0.2.3

package/dist/src/model-routing/router.d.ts

@@ -0,0 +1,149 @@
+import type { ThinkingLevel } from "@earendil-works/pi-ai";
+import type { ClassifierDecision, ClassifierInput, RouteTrigger } from "./classifier.js";
+import { type ResolvedTarget, type RouteContext, type RouteResolutionCatalog } from "./resolve.js";
+import type { RoutingTable } from "./table.js";
+import { type StepObservation, type TurnFacts } from "./step-triggers.js";
+/** Classifier seam kept independent from any agent runtime. */
+export type RouteClassifier = (input: ClassifierInput, signal?: AbortSignal) => Promise<ClassifierDecision>;
+/** Runtime inputs available when the router prepares a parent-agent turn. */
+export interface RouterPrepareInput {
+    /** Bounded summary of the preceding user-visible turn. */
+    prevTurnHint?: string;
+    /** Cancels classification without changing router state. */
+    signal?: AbortSignal;
+}
+/** An actual concrete-model or reasoning-effort change selected by the router. */
+export interface RouterSwitch {
+    /** Virtual tier whose policy selected the target. */
+    tier: string;
+    /** Final route used after virtual resolution and general fallthrough. */
+    route: string;
+    /** Previous concrete catalog name. */
+    fromModel: string;
+    /** New concrete catalog name. */
+    toModel: string;
+    /** Route-owned reasoning effort applied with the new model. */
+    thinkingLevel: ThinkingLevel;
+    /** Runtime milestone that requested classification. */
+    trigger: RouteTrigger;
+    /** Classifier explanation for the selected route. */
+    rationale: string;
+    /** True when image capability applied the selected route's fallback model. */
+    visionFallback: boolean;
+}
+/** Advisor rate-floor decision measured only in completed parent assistant steps. */
+export interface AdvisorGate {
+    /** Whether an ordinary advisor call may run at the current step. */
+    allowed: boolean;
+    /** Additional completed parent assistant steps required before a call is allowed. */
+    stepsUntilAllowed: number;
+    /** True when another consult already owns the session's advisor slot. */
+    inFlight?: boolean;
+}
+/** Complete read-only routing snapshot consumed by later CLI and TUI surfaces. */
+export interface RouterStatus {
+    /** Virtual tier whose routing policy owns this session. */
+    tier: string;
+    /** Current concrete route, absent only before `initialTarget` is called. */
+    route?: string;
+    /** Current concrete catalog name, absent only before boot resolution. */
+    modelName?: string;
+    /** Current route-owned effort, absent only before boot resolution. */
+    thinkingLevel?: ThinkingLevel;
+    /** Most recent successful classifier explanation. */
+    lastRationale?: string;
+    /** Number of completed parent assistant messages observed by the router. */
+    assistantSteps: number;
+    /** Steps remaining before cadence classification; zero means classification is due. */
+    stepsUntilClassification: number;
+    /** True when virtual routing is suspended by a concrete model pin. */
+    pinned: boolean;
+    /** Whether this tier exposes the advisor tool. */
+    advisorEnabled: boolean;
+    /** Current step-based advisor floor. */
+    advisorGate: AdvisorGate;
+    /** Sticky facts learned from the current user turn's prompt and step outputs. */
+    facts: TurnFacts;
+}
+export interface ModelRouterOptions {
+    /** Complete routing table loaded for this project. */
+    table: RoutingTable;
+    /** Virtual tier selected for this session. */
+    tier: string;
+    /** Injected route classifier; production binds it to the table classifier target. */
+    classify: RouteClassifier;
+    /** Injected concrete-model capability lookup used by route resolution. */
+    resolveCatalog: RouteResolutionCatalog;
+}
+/**
+ * Session-local routing state machine. It owns all cadence and interlock policy;
+ * callers only report runtime facts and apply returned switches.
+ */
+export declare class ModelRouter {
+    private readonly table;
+    private readonly tier;
+    private readonly classify;
+    private readonly resolveCatalog;
+    private current?;
+    private assistantSteps;
+    private lastClassificationStep;
+    private firstClassificationPending;
+    private advisorClassificationPending;
+    private stepTriggerClassificationPending;
+    private compactionClassificationPending;
+    private lastAdvisorStep?;
+    private lastStepDelta?;
+    private currentTurnHint?;
+    private lastRationale?;
+    private pinned;
+    private advisorConsultInFlight;
+    private facts;
+    /** Precomputed: the tier has exactly one possible destination, so classification is skipped. */
+    private readonly singleDestination;
+    constructor(options: ModelRouterOptions);
+    /**
+     * True when every route in the tier resolves to one identical
+     * `{model, effort}` pair, so classification cannot change anything —
+     * every classifier call (turn start, cadence, step trigger, advisor
+     * milestone) is skipped for the session. Applied per-route vision fallbacks
+     * participate because they can add a distinct model/effort destination.
+     */
+    private computeSingleDestination;
+    /** Resolve and retain the tier's general boot target before the first classifier call. */
+    initialTarget(context: RouteContext): ResolvedTarget;
+    /**
+     * Reset sticky routing facts from the new parent prompt at each user-turn
+     * boundary. A pending step-trigger arm deliberately survives: a trigger
+     * raised by the FINAL step of a turn has no intra-turn boundary left to
+     * consume it, so it rides into this turn's first classification instead of
+     * being silently dropped. Completed classifications clear every arm.
+     */
+    noteTurnStart(input: {
+        promptHasImages: boolean;
+    }): void;
+    /** Record one completed parent assistant step and evaluate its runtime-neutral output summary. */
+    noteAssistantStep(observation?: StepObservation): void;
+    /** Arm one cap-exempt classification after an independent wire-prefix compaction. */
+    noteCompaction(): void;
+    /** Suspend virtual routing while a concrete model is pinned. */
+    pin(): void;
+    /** Resume virtual routing without discarding milestones accumulated while pinned. */
+    unpin(): void;
+    /** True when a one-shot milestone or completed-step cadence requests classification. */
+    shouldClassify(): boolean;
+    /**
+     * Classify and resolve a due route. Provider failure, abort, or invalid
+     * resolution is deliberately a no-op so the active model and milestones stay intact.
+     */
+    prepareTurn(input: RouterPrepareInput): Promise<RouterSwitch | undefined>;
+    /** Current advisor floor; the first successful consult is always allowed. */
+    advisorGate(): AdvisorGate;
+    /** Atomically authorize one advisor attempt and reserve the session's consult slot. */
+    beginAdvisorConsult(): AdvisorGate;
+    /** Release the consult slot; only success stamps the floor and requests reclassification. */
+    endAdvisorConsult(success: boolean): void;
+    /** Return a detached snapshot; callers never infer routing policy from runner state. */
+    status(): RouterStatus;
+    private classificationTrigger;
+}
+//# sourceMappingURL=router.d.ts.map

package/dist/src/model-routing/router.d.ts.map

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

package/dist/src/model-routing/router.js

@@ -0,0 +1,235 @@
+import { resolveRoute, resolveTierDefault, } from "./resolve.js";
+import { evaluateStepTriggers } from "./step-triggers.js";
+/**
+ * Session-local routing state machine. It owns all cadence and interlock policy;
+ * callers only report runtime facts and apply returned switches.
+ */
+export class ModelRouter {
+    table;
+    tier;
+    classify;
+    resolveCatalog;
+    current;
+    assistantSteps = 0;
+    lastClassificationStep = 0;
+    firstClassificationPending = true;
+    advisorClassificationPending = false;
+    stepTriggerClassificationPending = false;
+    compactionClassificationPending = false;
+    lastAdvisorStep;
+    lastStepDelta;
+    currentTurnHint;
+    lastRationale;
+    pinned = false;
+    advisorConsultInFlight = false;
+    facts = { hasImages: false };
+    /** Precomputed: the tier has exactly one possible destination, so classification is skipped. */
+    singleDestination;
+    constructor(options) {
+        this.table = options.table;
+        this.tier = options.tier;
+        this.classify = options.classify;
+        this.resolveCatalog = options.resolveCatalog;
+        this.singleDestination = this.computeSingleDestination();
+    }
+    /**
+     * True when every route in the tier resolves to one identical
+     * `{model, effort}` pair, so classification cannot change anything —
+     * every classifier call (turn start, cadence, step trigger, advisor
+     * milestone) is skipped for the session. Applied per-route vision fallbacks
+     * participate because they can add a distinct model/effort destination.
+     */
+    computeSingleDestination() {
+        const tier = this.table.tiers[this.tier];
+        if (!tier)
+            return false;
+        const destinations = new Set();
+        for (const routeName of Object.keys(tier.routes)) {
+            try {
+                for (const hasImages of [false, true]) {
+                    const resolved = resolveRoute(this.table, this.tier, routeName, { hasImages }, this.resolveCatalog);
+                    destinations.add(`${resolved.modelName}\u0000${resolved.thinkingLevel}`);
+                }
+            }
+            catch {
+                // An unresolvable route means real routing decisions remain possible;
+                // never optimize classification away on a table we cannot fully read.
+                return false;
+            }
+            if (destinations.size > 1)
+                return false;
+        }
+        return destinations.size === 1;
+    }
+    /** Resolve and retain the tier's general boot target before the first classifier call. */
+    initialTarget(context) {
+        const target = resolveTierDefault(this.table, this.tier, context, this.resolveCatalog);
+        this.current = target;
+        return target;
+    }
+    /**
+     * Reset sticky routing facts from the new parent prompt at each user-turn
+     * boundary. A pending step-trigger arm deliberately survives: a trigger
+     * raised by the FINAL step of a turn has no intra-turn boundary left to
+     * consume it, so it rides into this turn's first classification instead of
+     * being silently dropped. Completed classifications clear every arm.
+     */
+    noteTurnStart(input) {
+        this.facts = { hasImages: input.promptHasImages };
+        this.currentTurnHint = undefined;
+    }
+    /** Record one completed parent assistant step and evaluate its runtime-neutral output summary. */
+    noteAssistantStep(observation = { blockTypes: [], text: "" }) {
+        this.assistantSteps += 1;
+        this.lastStepDelta = observation.text.trim() || undefined;
+        const effects = evaluateStepTriggers(observation, this.table.classifier.stepTriggers);
+        for (const effect of effects) {
+            this.facts = { ...this.facts, ...effect.facts };
+            if (effect.classify)
+                this.stepTriggerClassificationPending = true;
+        }
+    }
+    /** Arm one cap-exempt classification after an independent wire-prefix compaction. */
+    noteCompaction() {
+        this.compactionClassificationPending = true;
+    }
+    /** Suspend virtual routing while a concrete model is pinned. */
+    pin() {
+        this.pinned = true;
+    }
+    /** Resume virtual routing without discarding milestones accumulated while pinned. */
+    unpin() {
+        this.pinned = false;
+    }
+    /** True when a one-shot milestone or completed-step cadence requests classification. */
+    shouldClassify() {
+        if (this.pinned || this.singleDestination)
+            return false;
+        return (this.firstClassificationPending ||
+            this.advisorClassificationPending ||
+            this.stepTriggerClassificationPending ||
+            this.compactionClassificationPending ||
+            this.assistantSteps - this.lastClassificationStep >= this.table.classifier.everySteps);
+    }
+    /**
+     * Classify and resolve a due route. Provider failure, abort, or invalid
+     * resolution is deliberately a no-op so the active model and milestones stay intact.
+     */
+    async prepareTurn(input) {
+        if (input.prevTurnHint?.trim())
+            this.currentTurnHint = input.prevTurnHint;
+        if (!this.shouldClassify() || input.signal?.aborted)
+            return undefined;
+        const trigger = this.classificationTrigger();
+        const previous = this.current;
+        try {
+            const decision = await this.classify({
+                tierName: this.tier,
+                tier: this.table.tiers[this.tier],
+                guidance: this.table.classifier.guidance,
+                currentTarget: previous
+                    ? `${previous.modelName} because route ${previous.route}`
+                    : undefined,
+                prevTurnHint: this.currentTurnHint,
+                lastStepDelta: this.lastStepDelta,
+                hasImages: this.facts.hasImages,
+                trigger,
+            }, input.signal);
+            if (input.signal?.aborted)
+                return undefined;
+            const context = { hasImages: this.facts.hasImages };
+            const next = resolveRoute(this.table, this.tier, decision.route, context, this.resolveCatalog);
+            const baseline = previous ?? this.initialTarget(context);
+            this.current = next;
+            this.lastRationale = decision.rationale;
+            this.lastClassificationStep = this.assistantSteps;
+            this.firstClassificationPending = false;
+            this.advisorClassificationPending = false;
+            this.stepTriggerClassificationPending = false;
+            this.compactionClassificationPending = false;
+            if (baseline.modelName === next.modelName && baseline.thinkingLevel === next.thinkingLevel) {
+                return undefined;
+            }
+            const switched = {
+                tier: this.tier,
+                route: next.route,
+                fromModel: baseline.modelName,
+                toModel: next.modelName,
+                thinkingLevel: next.thinkingLevel,
+                trigger,
+                rationale: decision.rationale,
+                visionFallback: next.visionFallback,
+            };
+            // A replacement model starts with a fresh advisor floor. Its first
+            // consult is authorized by the ordinary gate; a successful consult then
+            // starts the normal step-based cooldown again.
+            this.lastAdvisorStep = undefined;
+            return switched;
+        }
+        catch {
+            return undefined;
+        }
+    }
+    /** Current advisor floor; the first successful consult is always allowed. */
+    advisorGate() {
+        if (this.lastAdvisorStep === undefined)
+            return { allowed: true, stepsUntilAllowed: 0 };
+        const minStepsBetween = this.table.tiers[this.tier].advisor.minStepsBetween;
+        const elapsed = this.assistantSteps - this.lastAdvisorStep;
+        const stepsUntilAllowed = Math.max(0, minStepsBetween - elapsed);
+        return { allowed: stepsUntilAllowed === 0, stepsUntilAllowed };
+    }
+    /** Atomically authorize one advisor attempt and reserve the session's consult slot. */
+    beginAdvisorConsult() {
+        if (this.advisorConsultInFlight) {
+            return { allowed: false, stepsUntilAllowed: 0, inFlight: true };
+        }
+        const gate = this.advisorGate();
+        if (gate.allowed)
+            this.advisorConsultInFlight = true;
+        return gate;
+    }
+    /** Release the consult slot; only success stamps the floor and requests reclassification. */
+    endAdvisorConsult(success) {
+        if (!this.advisorConsultInFlight)
+            return;
+        this.advisorConsultInFlight = false;
+        if (!success)
+            return;
+        this.lastAdvisorStep = this.assistantSteps;
+        this.advisorClassificationPending = true;
+    }
+    /** Return a detached snapshot; callers never infer routing policy from runner state. */
+    status() {
+        const cadenceRemaining = Math.max(0, this.table.classifier.everySteps - (this.assistantSteps - this.lastClassificationStep));
+        return {
+            tier: this.tier,
+            ...(this.current
+                ? {
+                    route: this.current.route,
+                    modelName: this.current.modelName,
+                    thinkingLevel: this.current.thinkingLevel,
+                }
+                : {}),
+            ...(this.lastRationale ? { lastRationale: this.lastRationale } : {}),
+            assistantSteps: this.assistantSteps,
+            stepsUntilClassification: this.shouldClassify() ? 0 : cadenceRemaining,
+            pinned: this.pinned,
+            advisorEnabled: this.table.tiers[this.tier].advisor.enabled,
+            advisorGate: this.advisorGate(),
+            facts: { ...this.facts },
+        };
+    }
+    classificationTrigger() {
+        if (this.firstClassificationPending)
+            return "turn_start";
+        if (this.advisorClassificationPending)
+            return "advisor";
+        if (this.stepTriggerClassificationPending)
+            return "step_trigger";
+        if (this.compactionClassificationPending)
+            return "compaction";
+        return "cadence";
+    }
+}
+//# sourceMappingURL=router.js.map

package/dist/src/model-routing/router.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"router.js","sourceRoot":"","sources":["../../../src/model-routing/router.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,YAAY,EACZ,kBAAkB,GAInB,MAAM,cAAc,CAAC;AAEtB,OAAO,EAAE,oBAAoB,EAAwC,MAAM,oBAAoB,CAAC;AAmFhG;;;GAGG;AACH,MAAM,OAAO,WAAW;IACL,KAAK,CAAe;IACpB,IAAI,CAAS;IACb,QAAQ,CAAkB;IAC1B,cAAc,CAAyB;IAChD,OAAO,CAAkB;IACzB,cAAc,GAAG,CAAC,CAAC;IACnB,sBAAsB,GAAG,CAAC,CAAC;IAC3B,0BAA0B,GAAG,IAAI,CAAC;IAClC,4BAA4B,GAAG,KAAK,CAAC;IACrC,gCAAgC,GAAG,KAAK,CAAC;IACzC,+BAA+B,GAAG,KAAK,CAAC;IACxC,eAAe,CAAU;IACzB,aAAa,CAAU;IACvB,eAAe,CAAU;IACzB,aAAa,CAAU;IACvB,MAAM,GAAG,KAAK,CAAC;IACf,sBAAsB,GAAG,KAAK,CAAC;IAC/B,KAAK,GAAc,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC;IAChD,gGAAgG;IAC/E,iBAAiB,CAAU;IAE5C,YAAY,OAA2B;QACrC,IAAI,CAAC,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC;QAC3B,IAAI,CAAC,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;QACzB,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC;QACjC,IAAI,CAAC,cAAc,GAAG,OAAO,CAAC,cAAc,CAAC;QAC7C,IAAI,CAAC,iBAAiB,GAAG,IAAI,CAAC,wBAAwB,EAAE,CAAC;IAC3D,CAAC;IAED;;;;;;OAMG;IACK,wBAAwB;QAC9B,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACzC,IAAI,CAAC,IAAI;YAAE,OAAO,KAAK,CAAC;QACxB,MAAM,YAAY,GAAG,IAAI,GAAG,EAAU,CAAC;QACvC,KAAK,MAAM,SAAS,IAAI,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;YACjD,IAAI,CAAC;gBACH,KAAK,MAAM,SAAS,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,EAAE,CAAC;oBACtC,MAAM,QAAQ,GAAG,YAAY,CAC3B,IAAI,CAAC,KAAK,EACV,IAAI,CAAC,IAAI,EACT,SAAS,EACT,EAAE,SAAS,EAAE,EACb,IAAI,CAAC,cAAc,CACpB,CAAC;oBACF,YAAY,CAAC,GAAG,CAAC,GAAG,QAAQ,CAAC,SAAS,SAAS,QAAQ,CAAC,aAAa,EAAE,CAAC,CAAC;gBAC3E,CAAC;YACH,CAAC;YAAC,MAAM,CAAC;gBACP,sEAAsE;gBACtE,sEAAsE;gBACtE,OAAO,KAAK,CAAC;YACf,CAAC;YACD,IAAI,YAAY,CAAC,IAAI,GAAG,CAAC;gBAAE,OAAO,KAAK,CAAC;QAC1C,CAAC;QACD,OAAO,YAAY,CAAC,IAAI,KAAK,CAAC,CAAC;IACjC,CAAC;IAED,0FAA0F;IAC1F,aAAa,CAAC,OAAqB;QACjC,MAAM,MAAM,GAAG,kBAAkB,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,IAAI,EAAE,OAAO,EAAE,IAAI,CAAC,cAAc,CAAC,CAAC;QACvF,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC;QACtB,OAAO,MAAM,CAAC;IAChB,CAAC;IAED;;;;;;OAMG;IACH,aAAa,CAAC,KAAmC;QAC/C,IAAI,CAAC,KAAK,GAAG,EAAE,SAAS,EAAE,KAAK,CAAC,eAAe,EAAE,CAAC;QAClD,IAAI,CAAC,eAAe,GAAG,SAAS,CAAC;IACnC,CAAC;IAED,kGAAkG;IAClG,iBAAiB,CAAC,cAA+B,EAAE,UAAU,EAAE,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE;QAC3E,IAAI,CAAC,cAAc,IAAI,CAAC,CAAC;QACzB,IAAI,CAAC,aAAa,GAAG,WAAW,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,SAAS,CAAC;QAC1D,MAAM,OAAO,GAAG,oBAAoB,CAAC,WAAW,EAAE,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,YAAY,CAAC,CAAC;QACtF,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;YAC7B,IAAI,CAAC,KAAK,GAAG,EAAE,GAAG,IAAI,CAAC,KAAK,EAAE,GAAG,MAAM,CAAC,KAAK,EAAE,CAAC;YAChD,IAAI,MAAM,CAAC,QAAQ;gBAAE,IAAI,CAAC,gCAAgC,GAAG,IAAI,CAAC;QACpE,CAAC;IACH,CAAC;IAED,qFAAqF;IACrF,cAAc;QACZ,IAAI,CAAC,+BAA+B,GAAG,IAAI,CAAC;IAC9C,CAAC;IAED,gEAAgE;IAChE,GAAG;QACD,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC;IACrB,CAAC;IAED,qFAAqF;IACrF,KAAK;QACH,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC;IACtB,CAAC;IAED,wFAAwF;IACxF,cAAc;QACZ,IAAI,IAAI,CAAC,MAAM,IAAI,IAAI,CAAC,iBAAiB;YAAE,OAAO,KAAK,CAAC;QACxD,OAAO,CACL,IAAI,CAAC,0BAA0B;YAC/B,IAAI,CAAC,4BAA4B;YACjC,IAAI,CAAC,gCAAgC;YACrC,IAAI,CAAC,+BAA+B;YACpC,IAAI,CAAC,cAAc,GAAG,IAAI,CAAC,sBAAsB,IAAI,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,UAAU,CACtF,CAAC;IACJ,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,WAAW,CAAC,KAAyB;QACzC,IAAI,KAAK,CAAC,YAAY,EAAE,IAAI,EAAE;YAAE,IAAI,CAAC,eAAe,GAAG,KAAK,CAAC,YAAY,CAAC;QAC1E,IAAI,CAAC,IAAI,CAAC,cAAc,EAAE,IAAI,KAAK,CAAC,MAAM,EAAE,OAAO;YAAE,OAAO,SAAS,CAAC;QAEtE,MAAM,OAAO,GAAG,IAAI,CAAC,qBAAqB,EAAE,CAAC;QAC7C,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC;QAC9B,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,QAAQ,CAClC;gBACE,QAAQ,EAAE,IAAI,CAAC,IAAI;gBACnB,IAAI,EAAE,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAE;gBAClC,QAAQ,EAAE,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,QAAQ;gBACxC,aAAa,EAAE,QAAQ;oBACrB,CAAC,CAAC,GAAG,QAAQ,CAAC,SAAS,kBAAkB,QAAQ,CAAC,KAAK,EAAE;oBACzD,CAAC,CAAC,SAAS;gBACb,YAAY,EAAE,IAAI,CAAC,eAAe;gBAClC,aAAa,EAAE,IAAI,CAAC,aAAa;gBACjC,SAAS,EAAE,IAAI,CAAC,KAAK,CAAC,SAAS;gBAC/B,OAAO;aACR,EACD,KAAK,CAAC,MAAM,CACb,CAAC;YACF,IAAI,KAAK,CAAC,MAAM,EAAE,OAAO;gBAAE,OAAO,SAAS,CAAC;YAE5C,MAAM,OAAO,GAAG,EAAE,SAAS,EAAE,IAAI,CAAC,KAAK,CAAC,SAAS,EAAE,CAAC;YACpD,MAAM,IAAI,GAAG,YAAY,CACvB,IAAI,CAAC,KAAK,EACV,IAAI,CAAC,IAAI,EACT,QAAQ,CAAC,KAAK,EACd,OAAO,EACP,IAAI,CAAC,cAAc,CACpB,CAAC;YACF,MAAM,QAAQ,GAAG,QAAQ,IAAI,IAAI,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC;YACzD,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC;YACpB,IAAI,CAAC,aAAa,GAAG,QAAQ,CAAC,SAAS,CAAC;YACxC,IAAI,CAAC,sBAAsB,GAAG,IAAI,CAAC,cAAc,CAAC;YAClD,IAAI,CAAC,0BAA0B,GAAG,KAAK,CAAC;YACxC,IAAI,CAAC,4BAA4B,GAAG,KAAK,CAAC;YAC1C,IAAI,CAAC,gCAAgC,GAAG,KAAK,CAAC;YAC9C,IAAI,CAAC,+BAA+B,GAAG,KAAK,CAAC;YAE7C,IAAI,QAAQ,CAAC,SAAS,KAAK,IAAI,CAAC,SAAS,IAAI,QAAQ,CAAC,aAAa,KAAK,IAAI,CAAC,aAAa,EAAE,CAAC;gBAC3F,OAAO,SAAS,CAAC;YACnB,CAAC;YAED,MAAM,QAAQ,GAAiB;gBAC7B,IAAI,EAAE,IAAI,CAAC,IAAI;gBACf,KAAK,EAAE,IAAI,CAAC,KAAK;gBACjB,SAAS,EAAE,QAAQ,CAAC,SAAS;gBAC7B,OAAO,EAAE,IAAI,CAAC,SAAS;gBACvB,aAAa,EAAE,IAAI,CAAC,aAAa;gBACjC,OAAO;gBACP,SAAS,EAAE,QAAQ,CAAC,SAAS;gBAC7B,cAAc,EAAE,IAAI,CAAC,cAAc;aACpC,CAAC;YACF,mEAAmE;YACnE,wEAAwE;YACxE,+CAA+C;YAC/C,IAAI,CAAC,eAAe,GAAG,SAAS,CAAC;YACjC,OAAO,QAAQ,CAAC;QAClB,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,SAAS,CAAC;QACnB,CAAC;IACH,CAAC;IAED,6EAA6E;IAC7E,WAAW;QACT,IAAI,IAAI,CAAC,eAAe,KAAK,SAAS;YAAE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,iBAAiB,EAAE,CAAC,EAAE,CAAC;QACvF,MAAM,eAAe,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAE,CAAC,OAAO,CAAC,eAAe,CAAC;QAC7E,MAAM,OAAO,GAAG,IAAI,CAAC,cAAc,GAAG,IAAI,CAAC,eAAe,CAAC;QAC3D,MAAM,iBAAiB,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,eAAe,GAAG,OAAO,CAAC,CAAC;QACjE,OAAO,EAAE,OAAO,EAAE,iBAAiB,KAAK,CAAC,EAAE,iBAAiB,EAAE,CAAC;IACjE,CAAC;IAED,uFAAuF;IACvF,mBAAmB;QACjB,IAAI,IAAI,CAAC,sBAAsB,EAAE,CAAC;YAChC,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,iBAAiB,EAAE,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;QAClE,CAAC;QACD,MAAM,IAAI,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC;QAChC,IAAI,IAAI,CAAC,OAAO;YAAE,IAAI,CAAC,sBAAsB,GAAG,IAAI,CAAC;QACrD,OAAO,IAAI,CAAC;IACd,CAAC;IAED,6FAA6F;IAC7F,iBAAiB,CAAC,OAAgB;QAChC,IAAI,CAAC,IAAI,CAAC,sBAAsB;YAAE,OAAO;QACzC,IAAI,CAAC,sBAAsB,GAAG,KAAK,CAAC;QACpC,IAAI,CAAC,OAAO;YAAE,OAAO;QACrB,IAAI,CAAC,eAAe,GAAG,IAAI,CAAC,cAAc,CAAC;QAC3C,IAAI,CAAC,4BAA4B,GAAG,IAAI,CAAC;IAC3C,CAAC;IAED,wFAAwF;IACxF,MAAM;QACJ,MAAM,gBAAgB,GAAG,IAAI,CAAC,GAAG,CAC/B,CAAC,EACD,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,UAAU,GAAG,CAAC,IAAI,CAAC,cAAc,GAAG,IAAI,CAAC,sBAAsB,CAAC,CACvF,CAAC;QACF,OAAO;YACL,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,GAAG,CAAC,IAAI,CAAC,OAAO;gBACd,CAAC,CAAC;oBACE,KAAK,EAAE,IAAI,CAAC,OAAO,CAAC,KAAK;oBACzB,SAAS,EAAE,IAAI,CAAC,OAAO,CAAC,SAAS;oBACjC,aAAa,EAAE,IAAI,CAAC,OAAO,CAAC,aAAa;iBAC1C;gBACH,CAAC,CAAC,EAAE,CAAC;YACP,GAAG,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,EAAE,aAAa,EAAE,IAAI,CAAC,aAAa,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACpE,cAAc,EAAE,IAAI,CAAC,cAAc;YACnC,wBAAwB,EAAE,IAAI,CAAC,cAAc,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,gBAAgB;YACtE,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,cAAc,EAAE,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAE,CAAC,OAAO,CAAC,OAAO;YAC5D,WAAW,EAAE,IAAI,CAAC,WAAW,EAAE;YAC/B,KAAK,EAAE,EAAE,GAAG,IAAI,CAAC,KAAK,EAAE;SACzB,CAAC;IACJ,CAAC;IAEO,qBAAqB;QAC3B,IAAI,IAAI,CAAC,0BAA0B;YAAE,OAAO,YAAY,CAAC;QACzD,IAAI,IAAI,CAAC,4BAA4B;YAAE,OAAO,SAAS,CAAC;QACxD,IAAI,IAAI,CAAC,gCAAgC;YAAE,OAAO,cAAc,CAAC;QACjE,IAAI,IAAI,CAAC,+BAA+B;YAAE,OAAO,YAAY,CAAC;QAC9D,OAAO,SAAS,CAAC;IACnB,CAAC;CACF"}

package/dist/src/model-routing/step-triggers.d.ts

@@ -0,0 +1,27 @@
+import type { StepTriggerConfig } from "./table.js";
+/** Pi-free summary of one completed assistant step and its tool-result output. */
+export interface StepObservation {
+    /** Content-block type names observed across the assistant message and tool results. */
+    blockTypes: readonly string[];
+    /** Caller-bounded concatenation of assistant and tool-result text blocks. */
+    text: string;
+}
+/** Sticky turn-scoped facts used by correctness routing policy. */
+export interface TurnFacts {
+    /** Whether any prompt attachment or step output in this user turn contains an image. */
+    hasImages: boolean;
+}
+/** Routing consequences contributed by one built-in or configured trigger. */
+export interface TriggerEffect {
+    /** Requests classification at the next model boundary. */
+    classify: boolean;
+    /** Sticky facts learned from the observed step. */
+    facts?: Partial<TurnFacts>;
+}
+/**
+ * Evaluate correctness and administrator-authored taste triggers for one step.
+ * Configured keywords use case-insensitive substring matching so tokens and phrases
+ * behave identically without imposing identifier or punctuation boundaries.
+ */
+export declare function evaluateStepTriggers(observation: StepObservation, configTriggers: readonly StepTriggerConfig[] | undefined): TriggerEffect[];
+//# sourceMappingURL=step-triggers.d.ts.map

package/dist/src/model-routing/step-triggers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"step-triggers.d.ts","sourceRoot":"","sources":["../../../src/model-routing/step-triggers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAGpD,kFAAkF;AAClF,MAAM,WAAW,eAAe;IAC9B,uFAAuF;IACvF,UAAU,EAAE,SAAS,MAAM,EAAE,CAAC;IAC9B,6EAA6E;IAC7E,IAAI,EAAE,MAAM,CAAC;CACd;AAED,mEAAmE;AACnE,MAAM,WAAW,SAAS;IACxB,wFAAwF;IACxF,SAAS,EAAE,OAAO,CAAC;CACpB;AAED,8EAA8E;AAC9E,MAAM,WAAW,aAAa;IAC5B,0DAA0D;IAC1D,QAAQ,EAAE,OAAO,CAAC;IAClB,mDAAmD;IACnD,KAAK,CAAC,EAAE,OAAO,CAAC,SAAS,CAAC,CAAC;CAC5B;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAClC,WAAW,EAAE,eAAe,EAC5B,cAAc,EAAE,SAAS,iBAAiB,EAAE,GAAG,SAAS,GACvD,aAAa,EAAE,CAajB"}

package/dist/src/model-routing/step-triggers.js

@@ -0,0 +1,20 @@
+import { stripSystemReminders } from "../lib/system-reminder.js";
+/**
+ * Evaluate correctness and administrator-authored taste triggers for one step.
+ * Configured keywords use case-insensitive substring matching so tokens and phrases
+ * behave identically without imposing identifier or punctuation boundaries.
+ */
+export function evaluateStepTriggers(observation, configTriggers) {
+    const effects = [];
+    if (observation.blockTypes.includes("image")) {
+        effects.push({ classify: true, facts: { hasImages: true } });
+    }
+    const normalizedText = stripSystemReminders(observation.text).toLocaleLowerCase();
+    for (const trigger of configTriggers ?? []) {
+        if (trigger.keywords.some((keyword) => normalizedText.includes(keyword.toLocaleLowerCase()))) {
+            effects.push({ classify: true });
+        }
+    }
+    return effects;
+}
+//# sourceMappingURL=step-triggers.js.map

package/dist/src/model-routing/step-triggers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"step-triggers.js","sourceRoot":"","sources":["../../../src/model-routing/step-triggers.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AAwBjE;;;;GAIG;AACH,MAAM,UAAU,oBAAoB,CAClC,WAA4B,EAC5B,cAAwD;IAExD,MAAM,OAAO,GAAoB,EAAE,CAAC;IACpC,IAAI,WAAW,CAAC,UAAU,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;QAC7C,OAAO,CAAC,IAAI,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,EAAE,CAAC,CAAC;IAC/D,CAAC;IAED,MAAM,cAAc,GAAG,oBAAoB,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,iBAAiB,EAAE,CAAC;IAClF,KAAK,MAAM,OAAO,IAAI,cAAc,IAAI,EAAE,EAAE,CAAC;QAC3C,IAAI,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,cAAc,CAAC,QAAQ,CAAC,OAAO,CAAC,iBAAiB,EAAE,CAAC,CAAC,EAAE,CAAC;YAC7F,OAAO,CAAC,IAAI,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC;QACnC,CAAC;IACH,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/src/model-routing/table.d.ts

@@ -0,0 +1,126 @@
+import type { ThinkingLevel } from "@earendil-works/pi-ai";
+import { Type } from "typebox";
+/** Complete, replaceable configuration for virtual model routing. */
+export declare const RoutingTableSchema: Type.TObject<{
+    defaultTier: Type.TString;
+    tiers: Type.TRecord<"^.*$", Type.TObject<{
+        routes: Type.TRecord<"^.*$", Type.TObject<{
+            description: Type.TString;
+            target: Type.TObject<{
+                modelName: Type.TString;
+                thinkingLevel: Type.TUnion<Type.TLiteral<"minimal" | "low" | "medium" | "high" | "xhigh">[]>;
+            }>;
+            visionFallbackModelName: Type.TOptional<Type.TString>;
+        }>>;
+        advisor: Type.TObject<{
+            enabled: Type.TBoolean;
+            target: Type.TObject<{
+                modelName: Type.TString;
+                thinkingLevel: Type.TUnion<Type.TLiteral<"minimal" | "low" | "medium" | "high" | "xhigh">[]>;
+            }>;
+            minStepsBetween: Type.TInteger;
+            transcriptTokens: Type.TInteger;
+        }>;
+    }>>;
+    classifier: Type.TObject<{
+        target: Type.TObject<{
+            modelName: Type.TString;
+            thinkingLevel: Type.TUnion<Type.TLiteral<"minimal" | "low" | "medium" | "high" | "xhigh">[]>;
+        }>;
+        everySteps: Type.TInteger;
+        guidance: Type.TString;
+        stepTriggers: Type.TOptional<Type.TArray<Type.TObject<{
+            name: Type.TString;
+            keywords: Type.TArray<Type.TString>;
+        }>>>;
+    }>;
+}>;
+/** A model plus the reasoning effort the router applies to it. */
+export interface RouteTarget {
+    /** Concrete catalog name, or another virtual tier name for recursive routing. */
+    modelName: string;
+    /** Reasoning effort that applies once this target resolves to a concrete model. */
+    thinkingLevel: ThinkingLevel;
+}
+/** Classifier-facing route metadata and the target selected by that route. */
+export interface RouteRule {
+    /** Explains the route's operational intent to the classifier. */
+    description: string;
+    /** Model and effort selected when the classifier chooses this route. */
+    target: RouteTarget;
+    /**
+     * Optional image-capable concrete model or virtual tier used when `target` is text-only.
+     * Resolution preserves this route's `thinkingLevel`; omission deliberately degrades in place.
+     */
+    visionFallbackModelName?: string;
+}
+/** Per-tier policy for exposing and rate-limiting the advisor. */
+export interface AdvisorPolicy {
+    /** Controls whether the tier exposes the advisor tool. */
+    enabled: boolean;
+    /** Model and effort used for advisor calls. */
+    target: RouteTarget;
+    /** Minimum completed assistant steps between ordinary advisor calls. */
+    minStepsBetween: number;
+    /** Token budget for the curated advisor transcript; validation caps it at 20,000. */
+    transcriptTokens: number;
+}
+/** Routes and policies owned by one virtual model tier. */
+export interface TierDefinition {
+    /** Named classifier routes; an absent requested route falls through to `general`. */
+    routes: Record<string, RouteRule>;
+    /** Advisor availability, target, cadence, and transcript budget for this tier. */
+    advisor: AdvisorPolicy;
+}
+/** Shared classifier model, cadence, and administrator-authored routing guidance. */
+export interface ClassifierConfig {
+    /** Cheap model and effort used for route classification. */
+    target: RouteTarget;
+    /** Number of completed assistant steps between intra-turn classifications. */
+    everySteps: number;
+    /** Freeform prompt guidance appended after the generated route descriptions. */
+    guidance: string;
+    /** Optional taste triggers matched against bounded text from each completed assistant step. */
+    stepTriggers?: StepTriggerConfig[];
+}
+/** Administrator-authored step-output trigger; correctness triggers remain built-in code. */
+export interface StepTriggerConfig {
+    /** Non-empty name unique within `classifier.stepTriggers`. */
+    name: string;
+    /** Non-empty strings matched as case-insensitive substrings against step output. */
+    keywords: string[];
+}
+/** Complete routing configuration. A file override replaces this object as a whole. */
+export interface RoutingTable {
+    /** Tier used during boot before a caller or classifier selects another tier. */
+    defaultTier: string;
+    /** Virtual names mapped to their route and advisor definitions. */
+    tiers: Record<string, TierDefinition>;
+    /** Configuration for the shared route classifier. */
+    classifier: ClassifierConfig;
+}
+/** Concrete catalog capabilities injected by model-resolution composition sites. */
+export interface RoutingCatalogAdapter {
+    /** True for every concrete shorthand or alias accepted by model resolution. */
+    isCatalogName(name: string): boolean;
+    /** True when the concrete model accepts image inputs. */
+    modelAcceptsImages(name: string): boolean;
+}
+/** Stable validation diagnostic returned without throwing. */
+export interface RoutingTableIssue {
+    /** Machine-readable category for callers that want to group diagnostics. */
+    code: "catalog_collision" | "dangling_reference" | "virtual_cycle" | "invalid_effort" | "invalid_cadence" | "invalid_transcript_budget" | "invalid_vision_fallback_model" | "invalid_step_trigger_name" | "duplicate_step_trigger_name" | "invalid_step_trigger_keywords";
+    /** Dot-delimited location of the invalid value in the table. */
+    path: string;
+    /** Human-readable explanation, including the full path for virtual cycles. */
+    message: string;
+}
+/** Built-in routing policy fixed by the model-router planning record. */
+export declare const BUILT_IN_ROUTING_TABLE: RoutingTable;
+/** True when `name` is owned by this routing table rather than the concrete catalog. */
+export declare function isVirtualModel(name: string, table: RoutingTable): boolean;
+/** Virtual model names in deterministic table insertion order. */
+export declare function virtualModelNames(table: RoutingTable): string[];
+/** Validate cross-field routing invariants against an injected concrete-model catalog. */
+export declare function validateRoutingTable(table: RoutingTable, catalogAdapter: RoutingCatalogAdapter): RoutingTableIssue[];
+//# sourceMappingURL=table.d.ts.map

package/dist/src/model-routing/table.d.ts.map

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