@mupt-ai/dari-router 0.1.0

package/dist/selector_input.d.ts

@@ -0,0 +1,42 @@
+import { type CandidateCostEstimate, type ChatMessage, type CustomRouterRule, type PreviousDecision, type ReasoningEffort, type RouterEval, type RoutingCandidate } from "./types.js";
+type SelectorCandidate = {
+    model: string;
+    thinking_level: RoutingCandidate["reasoningEffort"];
+};
+type SelectorPreviousDecision = SelectorCandidate & {
+    reason: string;
+};
+export type SelectorInput = {
+    candidate_pairs: SelectorCandidate[];
+    imported_evals: Array<Record<string, unknown>>;
+    previous_decision: SelectorPreviousDecision | null;
+    cost_estimates: CandidateCostEstimate[] | null;
+    messages: ChatMessage[];
+};
+type SelectorCustomRule = Omit<CustomRouterRule, "thinking_level"> & {
+    thinking_level: ReasoningEffort | null;
+};
+export type CustomSelectorInput = SelectorInput & {
+    custom_rules: SelectorCustomRule[];
+    default_target: {
+        model: string;
+        thinking_level: ReasoningEffort | null;
+    } | null;
+};
+export declare function selectorSafeMessages(messages: ChatMessage[]): ChatMessage[];
+export declare function buildSelectorInput(args: {
+    candidates: RoutingCandidate[];
+    evals: RouterEval[];
+    previousDecision: PreviousDecision | null;
+    costEstimates: CandidateCostEstimate[] | null;
+    messages: ChatMessage[];
+    customRules?: CustomRouterRule[];
+    defaultTarget?: {
+        model: string;
+        thinkingLevel: ReasoningEffort | null;
+    } | null;
+    modelFallbackEnabled?: boolean;
+    fallbackRequiresDifferentProvider?: boolean;
+    imputeEvalScores?: boolean;
+}): SelectorInput | CustomSelectorInput;
+export {};

package/dist/selector_input.js

@@ -0,0 +1,153 @@
+// Builds the selector input: candidate pairs, matched eval scores, cost
+// estimates, the previous decision, and the (image-scrubbed) conversation.
+// The system prompts live in prompts.ts.
+import { isRecord, REASONING_EFFORTS, routingCandidateKey, } from "./types.js";
+const IMAGE_OMITTED_PLACEHOLDER = "<image omitted>";
+// Selector serialization must not include image bytes. The provider-facing
+// request and prefix fingerprint still use the original content, while this
+// stable placeholder preserves the selector's own prompt cache behavior.
+export function selectorSafeMessages(messages) {
+    return messages.map((message) => {
+        if (!Array.isArray(message.content))
+            return message;
+        return {
+            ...message,
+            content: message.content.map((part) => isRecord(part) && part.type === "image_url"
+                ? { type: "image_url", image_url: { url: IMAGE_OMITTED_PLACEHOLDER } }
+                : part),
+        };
+    });
+}
+export function buildSelectorInput(args) {
+    const input = {
+        candidate_pairs: args.candidates.map(({ model, reasoningEffort }) => ({
+            model,
+            thinking_level: reasoningEffort,
+        })),
+        imported_evals: formatImportedEvals(args.evals, args.candidates, args.imputeEvalScores ?? false),
+        previous_decision: args.previousDecision
+            ? {
+                model: args.previousDecision.model,
+                thinking_level: args.previousDecision.reasoningEffort,
+                reason: args.previousDecision.reason,
+            }
+            : null,
+        cost_estimates: args.costEstimates,
+        messages: args.messages,
+    };
+    if (args.customRules !== undefined) {
+        input.custom_rules = args.customRules.map((rule) => ({
+            ...rule,
+            thinking_level: rule.thinking_level ?? null,
+        }));
+        input.default_target = args.defaultTarget
+            ? {
+                model: args.defaultTarget.model,
+                thinking_level: args.defaultTarget.thinkingLevel,
+            }
+            : null;
+    }
+    return input;
+}
+function formatImportedEvals(evals, candidates, imputeEvalScores) {
+    return evals.flatMap((evalCard) => {
+        const scores = matchingEvalScores(evalCard.scores, candidates, imputeEvalScores);
+        if (scores.length === 0)
+            return [];
+        return [
+            {
+                id: evalCard.id,
+                name: evalCard.name,
+                description: evalCard.description ?? null,
+                min_score: evalCard.min_score,
+                max_score: evalCard.max_score,
+                scores,
+            },
+        ];
+    });
+}
+function matchingEvalScores(scores, candidates, imputeEvalScores) {
+    const uniqueCandidates = new Map(candidates.map((candidate) => [routingCandidateKey(candidate), candidate]));
+    return [...uniqueCandidates.values()].flatMap((candidate) => {
+        const modelScores = scores.filter((score) => score.model_id === candidate.model);
+        const exact = modelScores.find((score) => score.thinking_level === candidate.reasoningEffort);
+        const generic = modelScores.find((score) => score.thinking_level == null);
+        const match = exact ?? generic;
+        if (match) {
+            return [
+                {
+                    model_id: candidate.model,
+                    thinking_level: candidate.reasoningEffort,
+                    score: match.score,
+                    ...normalizedScore(match.score, scores),
+                    notes: match.notes ?? null,
+                },
+            ];
+        }
+        if (!imputeEvalScores)
+            return [];
+        const imputed = interpolatedScore(candidate, modelScores);
+        if (imputed === null)
+            return [];
+        return [
+            {
+                model_id: candidate.model,
+                thinking_level: candidate.reasoningEffort,
+                score: imputed,
+                ...normalizedScore(imputed, scores),
+                notes: null,
+                imputed: true,
+            },
+        ];
+    });
+}
+// Linear interpolation between the two per-level scores that bracket the
+// requested thinking level. A single known level (or zero) is not enough to
+// pin a line, so we only interpolate when the candidate has scores on both
+// sides of the requested level; one-sided cases stay empty.
+function interpolatedScore(candidate, modelScores) {
+    const requestedIndex = REASONING_EFFORTS.indexOf(candidate.reasoningEffort);
+    if (requestedIndex < 0)
+        return null;
+    let below = null;
+    let above = null;
+    for (const entry of modelScores) {
+        if (entry.thinking_level == null)
+            continue;
+        const index = REASONING_EFFORTS.indexOf(entry.thinking_level);
+        if (index < 0)
+            continue;
+        if (index < requestedIndex && (below === null || index > below.index)) {
+            below = { index, score: entry.score };
+        }
+        else if (index > requestedIndex &&
+            (above === null || index < above.index)) {
+            above = { index, score: entry.score };
+        }
+    }
+    if (below === null || above === null)
+        return null;
+    const ratio = (requestedIndex - below.index) / (above.index - below.index);
+    return round2(below.score + (above.score - below.score) * ratio);
+}
+// Positions a candidate's score against every model on the scorecard, not just
+// the candidates that survived pruning. Candidate-relative normalization would
+// move with the pruned set (with two candidates a z-score is always +/-1), so
+// the selector would read pure ordering as if it carried magnitude.
+function normalizedScore(score, population) {
+    const values = population.map((entry) => entry.score);
+    const mean = values.reduce((total, value) => total + value, 0) / values.length;
+    const variance = values.reduce((total, value) => total + (value - mean) ** 2, 0) /
+        values.length;
+    const stdDev = Math.sqrt(variance);
+    return {
+        // Competition ranking, best score first; tied scores share the low rank.
+        rank: 1 + values.filter((value) => value > score).length,
+        rank_total: values.length,
+        z_score: stdDev === 0 ? 0 : round2((score - mean) / stdDev),
+    };
+}
+function round2(value) {
+    return Math.round(value * 100) / 100;
+}
+//# sourceMappingURL=selector_input.js.map

package/dist/selector_input.js.map

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

package/dist/selector_parse.d.ts

@@ -0,0 +1,13 @@
+import { type RoutingCandidate, type RoutingDecision } from "./types.js";
+export type ParsedSelectorDecision = {
+    decision: RoutingDecision;
+    fallbackDecision?: RoutingDecision;
+};
+export declare function parseSelectorDecision(text: string): ParsedSelectorDecision;
+export declare function validateSelectorDecisions(args: {
+    decision: RoutingDecision;
+    fallbackDecision?: RoutingDecision;
+    candidates: RoutingCandidate[];
+    modelFallbackEnabled?: boolean;
+    fallbackRequiresDifferentProvider?: boolean;
+}): void;

package/dist/selector_parse.js

@@ -0,0 +1,95 @@
+import { RouterCoreError } from "./errors.js";
+import { providerForModel } from "./model_ids.js";
+import { isReasoningEffort, sameRoutingCandidate, } from "./types.js";
+// Parses the selector's raw output text into a routing decision (plus an
+// optional fallback). Tolerates a fenced ```json block; everything else must
+// be strict JSON matching the routing_decision schema.
+export function parseSelectorDecision(text) {
+    const trimmed = text.trim().replace(/^```json\s*/i, "").replace(/^```\s*/i, "").replace(/```$/i, "").trim();
+    let parsed;
+    try {
+        parsed = JSON.parse(trimmed);
+    }
+    catch {
+        throw new RouterCoreError("selector_output", "Selector returned invalid JSON.", "selector_invalid_json");
+    }
+    if (typeof parsed !== "object" || parsed === null || Array.isArray(parsed)) {
+        throw new RouterCoreError("selector_output", "Selector returned invalid routing decision.", "selector_invalid_response");
+    }
+    const record = parsed;
+    if (typeof record.selected_model !== "string" || record.selected_model === "") {
+        throw new RouterCoreError("selector_output", "Selector response missing selected_model.", "selector_invalid_response");
+    }
+    if (!isReasoningEffort(record.reasoning_effort)) {
+        throw new RouterCoreError("selector_output", "Selector response missing a valid reasoning_effort.", "selector_invalid_response");
+    }
+    const reason = typeof record.reason === "string" ? record.reason.trim() : "";
+    const leaseTurnsRemaining = typeof record.lease_turns_remaining === "number" && Number.isFinite(record.lease_turns_remaining)
+        ? Math.trunc(record.lease_turns_remaining)
+        : undefined;
+    const decision = {
+        selectedModel: record.selected_model,
+        reasoningEffort: record.reasoning_effort,
+        reason: reason ||
+            `Selector selected ${record.selected_model}/${record.reasoning_effort}; no reason was provided.`,
+        ...(leaseTurnsRemaining === undefined ? {} : { leaseTurnsRemaining }),
+    };
+    const fallbackModel = record.fallback_model;
+    const fallbackEffort = record.fallback_reasoning_effort;
+    const fallbackReason = record.fallback_reason;
+    // Selectors that decline a fallback often still explain why in
+    // fallback_reason; a missing fallback_model alone means "no fallback".
+    const noFallback = fallbackModel === null || fallbackModel === undefined;
+    if (noFallback)
+        return { decision };
+    if (typeof fallbackModel !== "string" ||
+        !fallbackModel ||
+        !isReasoningEffort(fallbackEffort) ||
+        (fallbackReason !== undefined &&
+            fallbackReason !== null &&
+            typeof fallbackReason !== "string")) {
+        throw new RouterCoreError("selector_output", "Selector response contains an incomplete fallback decision.", "selector_invalid_response");
+    }
+    const normalizedFallbackReason = fallbackReason?.trim() ?? "";
+    return {
+        decision,
+        fallbackDecision: {
+            selectedModel: fallbackModel,
+            reasoningEffort: fallbackEffort,
+            reason: normalizedFallbackReason ||
+                `Selector ranked ${fallbackModel}/${fallbackEffort} as the fallback; no reason was provided.`,
+        },
+    };
+}
+// Validates a parsed selector decision against the candidate set and fallback
+// policy: the selection must be a real candidate pair, and when fallback is
+// enabled a fallback must be present whenever an eligible one exists and must
+// itself be an eligible candidate on a distinct model (and provider, when
+// required).
+export function validateSelectorDecisions(args) {
+    const selected = {
+        model: args.decision.selectedModel,
+        reasoningEffort: args.decision.reasoningEffort,
+    };
+    if (!args.candidates.some((candidate) => sameRoutingCandidate(candidate, selected))) {
+        throw new RouterCoreError("selector_output", "Selector returned a model/thinking-level pair outside this router's candidates.", "selector_invalid_candidate");
+    }
+    const eligibleFallbacks = args.candidates.filter((candidate) => candidate.model !== selected.model &&
+        (!args.fallbackRequiresDifferentProvider ||
+            providerForModel(candidate.model) !== providerForModel(selected.model)));
+    if (args.modelFallbackEnabled) {
+        if (!args.fallbackDecision && eligibleFallbacks.length > 0) {
+            throw new RouterCoreError("selector_output", "Selector response missing an eligible fallback model.", "selector_invalid_response");
+        }
+        if (args.fallbackDecision) {
+            const fallback = {
+                model: args.fallbackDecision.selectedModel,
+                reasoningEffort: args.fallbackDecision.reasoningEffort,
+            };
+            if (!eligibleFallbacks.some((candidate) => sameRoutingCandidate(candidate, fallback))) {
+                throw new RouterCoreError("selector_output", "Selector returned an ineligible fallback model/thinking-level pair.", "selector_invalid_candidate");
+            }
+        }
+    }
+}
+//# sourceMappingURL=selector_parse.js.map

package/dist/selector_parse.js.map

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

package/dist/selector_request.d.ts

@@ -0,0 +1,26 @@
+import { type CustomSelectorInput, type SelectorInput } from "./selector_input.js";
+import type { CandidateCostEstimate, ChatCompletionRequest, ChatMessage, CustomRouterRule, PreviousDecision, ReasoningEffort, RouterEval, RoutingCandidate } from "./types.js";
+export type BuiltSelectorRequest = {
+    selectorInput: SelectorInput | CustomSelectorInput;
+    selectorRequest: ChatCompletionRequest;
+};
+export type SelectorRequestArgs = {
+    candidates: RoutingCandidate[];
+    evals?: RouterEval[];
+    previousDecision?: PreviousDecision;
+    costEstimates?: CandidateCostEstimate[];
+    customRules?: CustomRouterRule[];
+    defaultTarget?: {
+        model: string;
+        thinkingLevel: ReasoningEffort | null;
+    } | null;
+    selectorModel: string;
+    messages: ChatMessage[];
+    modelFallbackEnabled?: boolean;
+    fallbackRequiresDifferentProvider?: boolean;
+    imputeEvalScores?: boolean;
+};
+export declare function buildSizedSelectorRequest(args: SelectorRequestArgs & {
+    contextWindowChars: number;
+}): BuiltSelectorRequest;
+export declare function buildSelectorRequest(args: SelectorRequestArgs): BuiltSelectorRequest;

package/dist/selector_request.js

@@ -0,0 +1,85 @@
+import { RouterCoreError } from "./errors.js";
+import { CUSTOM_SELECTOR_SYSTEM_PROMPT, SELECTOR_SYSTEM_PROMPT } from "./prompts.js";
+import { buildSelectorInput, } from "./selector_input.js";
+import { trimMessagesFromFront } from "./selector_truncation.js";
+import { REASONING_EFFORTS } from "./types.js";
+// Builds the selector request, front-trimming conversation messages until the
+// serialized prompt fits the selector's context window. The window size is an
+// explicit input (in characters) so the core stays free of model-registry
+// lookups.
+export function buildSizedSelectorRequest(args) {
+    let messages = args.messages;
+    let built = buildSelectorRequest({ ...args, messages });
+    let previousInputChars = Number.POSITIVE_INFINITY;
+    while (true) {
+        const inputChars = selectorRequestInputChars(built.selectorRequest);
+        if (inputChars <= args.contextWindowChars)
+            return built;
+        if (inputChars >= previousInputChars) {
+            throw new RouterCoreError("configuration", `Selector prompt cannot fit configured context window for ${args.selectorModel}.`, "configuration_error");
+        }
+        previousInputChars = inputChars;
+        messages = trimMessagesFromFront(messages, inputChars - args.contextWindowChars);
+        built = buildSelectorRequest({ ...args, messages });
+    }
+}
+function selectorRequestInputChars(request) {
+    return JSON.stringify(request.messages ?? []).length;
+}
+export function buildSelectorRequest(args) {
+    const isCustom = args.customRules !== undefined;
+    const selectorInput = buildSelectorInput({
+        candidates: args.candidates,
+        evals: args.evals ?? [],
+        previousDecision: args.previousDecision ?? null,
+        costEstimates: args.costEstimates ?? null,
+        messages: args.messages,
+        customRules: args.customRules,
+        defaultTarget: args.defaultTarget,
+        modelFallbackEnabled: args.modelFallbackEnabled,
+        fallbackRequiresDifferentProvider: args.fallbackRequiresDifferentProvider,
+        imputeEvalScores: args.imputeEvalScores,
+    });
+    return {
+        selectorInput,
+        selectorRequest: {
+            model: args.selectorModel,
+            messages: [
+                { role: "system", content: isCustom ? CUSTOM_SELECTOR_SYSTEM_PROMPT : SELECTOR_SYSTEM_PROMPT },
+                {
+                    role: "user",
+                    content: JSON.stringify(selectorInput),
+                },
+            ],
+            // The selector is an internal fixed-purpose JSON pick; it must not inherit
+            // the client-facing implicit-medium reasoning default. Selector models
+            // must support a true off mode.
+            reasoning_effort: "off",
+            response_format: {
+                type: "json_schema",
+                json_schema: {
+                    name: "routing_decision",
+                    strict: true,
+                    schema: {
+                        type: "object",
+                        additionalProperties: false,
+                        properties: {
+                            selected_model: { type: "string" },
+                            reasoning_effort: {
+                                type: "string",
+                                enum: [...REASONING_EFFORTS],
+                            },
+                            reason: { type: "string" },
+                        },
+                        required: [
+                            "selected_model",
+                            "reasoning_effort",
+                            "reason",
+                        ],
+                    },
+                },
+            },
+        },
+    };
+}
+//# sourceMappingURL=selector_request.js.map

package/dist/selector_request.js.map

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

package/dist/selector_truncation.d.ts

@@ -0,0 +1,2 @@
+import { type ChatMessage } from "./types.js";
+export declare function trimMessagesFromFront(messages: ChatMessage[], dropChars: number): ChatMessage[];

package/dist/selector_truncation.js

@@ -0,0 +1,48 @@
+// Selector prompt sizing. The selector can see a front-trimmed view of the
+// conversation; the eventual provider call still receives the full request.
+import { isRecord } from "./types.js";
+const SELECTOR_TRUNCATION_MARKER = "<earlier messages truncated for routing>";
+const MARKER_MESSAGE = { role: "user", content: SELECTOR_TRUNCATION_MARKER };
+// Drop oldest messages first — in multi-turn conversations the latest
+// messages carry the routing signal.
+export function trimMessagesFromFront(messages, dropChars) {
+    const targetLength = Math.max(0, JSON.stringify(messages).length - Math.max(0, dropChars));
+    const kept = [...messages];
+    while (kept.length > 1 && JSON.stringify([MARKER_MESSAGE, ...kept]).length > targetLength) {
+        kept.shift();
+    }
+    const marked = [MARKER_MESSAGE, ...kept];
+    if (JSON.stringify(marked).length <= targetLength)
+        return marked;
+    if (kept.length === 1) {
+        const first = kept[0];
+        const trimmableContent = trimSourceContent(first);
+        if (trimmableContent === null)
+            return [MARKER_MESSAGE];
+        const prefix = `${SELECTOR_TRUNCATION_MARKER}\n`;
+        let content = `${prefix}${trimmableContent}`;
+        while (content.length > prefix.length) {
+            const excess = JSON.stringify([{ ...first, content }]).length - targetLength;
+            if (excess <= 0)
+                break;
+            content = `${prefix}${content.slice(prefix.length + excess)}`;
+        }
+        return [{ ...first, content }];
+    }
+    return [MARKER_MESSAGE];
+}
+function trimSourceContent(message) {
+    if (typeof message.content === "string")
+        return message.content;
+    if (!Array.isArray(message.content))
+        return null;
+    return message.content.map(formatContentPartForTrim).join("\n");
+}
+function formatContentPartForTrim(part) {
+    if (isRecord(part) && part.type === "text" && typeof part.text === "string")
+        return part.text;
+    if (isRecord(part) && part.type === "image_url")
+        return "<image omitted>";
+    return JSON.stringify(part);
+}
+//# sourceMappingURL=selector_truncation.js.map

package/dist/selector_truncation.js.map

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

package/dist/selector_wire.d.ts

@@ -0,0 +1,10 @@
+import { type Rng } from "./anonymous_actions.js";
+import type { SelectorInput } from "./selector_input.js";
+import { type PreviousDecision, type RoutingCandidate } from "./types.js";
+export type DecodedSelectorRequest = {
+    candidates: RoutingCandidate[];
+    previousDecision?: PreviousDecision;
+    selectorInput: SelectorInput;
+};
+export declare function decodeUntrustedSelectorRequest(payload: unknown): DecodedSelectorRequest;
+export declare function assertAnonymizableSelectorInput(selectorInput: SelectorInput, candidates: RoutingCandidate[], rng?: Rng): void;

package/dist/selector_wire.js

@@ -0,0 +1,113 @@
+// Inverse codec for the selector-request wire format buildSelectorRequest
+// produces: the selector input travels as a JSON-stringified user message
+// inside a chat-completion request.
+import { anonymizeSelectorInput, assignAnonymousActions, } from "./anonymous_actions.js";
+import { RouterFrameworkError } from "./framework_error.js";
+import { isReasoningEffort, isRecord, routingCandidateKey, } from "./types.js";
+// Decodes an untrusted POSTed selector request body; throws kind
+// "invalid_request" on malformed input.
+export function decodeUntrustedSelectorRequest(payload) {
+    const selectorInput = parseSelectorInput(payload);
+    const candidates = [];
+    const seenPairs = new Set();
+    for (const [index, pair] of selectorInput.candidate_pairs.entries()) {
+        const param = `candidate_pairs[${index}]`;
+        if (!isRecord(pair)) {
+            throw invalidSelectorRequest("Selector candidate must be an object.", param);
+        }
+        const candidate = parseCandidatePair(pair, "candidate", param);
+        const key = routingCandidateKey(candidate);
+        if (seenPairs.has(key)) {
+            throw invalidSelectorRequest(`Selector input contains duplicate candidate ${candidate.model}/${candidate.reasoningEffort}.`, param);
+        }
+        seenPairs.add(key);
+        candidates.push(candidate);
+    }
+    const previousDecision = parsePreviousDecision(selectorInput.previous_decision);
+    if (candidates.length === 0) {
+        throw invalidSelectorRequest("Selector request contains no candidates.");
+    }
+    return { candidates, ...(previousDecision !== undefined ? { previousDecision } : {}), selectorInput };
+}
+// anonymizeSelectorInput's validators throw plain Errors; dry-run it here so
+// malformed input surfaces as invalid_request instead of an internal error.
+export function assertAnonymizableSelectorInput(selectorInput, candidates, rng = Math.random) {
+    if (candidates.length < 2)
+        return;
+    try {
+        anonymizeSelectorInput(selectorInput, assignAnonymousActions(candidates, rng));
+    }
+    catch (error) {
+        throw invalidSelectorRequest(`Selector input is invalid: ${error instanceof Error ? error.message : String(error)}`);
+    }
+}
+function parsePreviousDecision(value) {
+    if (value === null || value === undefined)
+        return undefined;
+    if (!isRecord(value)) {
+        throw invalidSelectorRequest("Selector previous_decision must be an object or null.", "previous_decision");
+    }
+    const candidate = parseCandidatePair(value, "previous_decision", "previous_decision");
+    if (typeof value.reason !== "string") {
+        throw invalidSelectorRequest("Selector previous_decision reason must be a string.", "previous_decision.reason");
+    }
+    return { ...candidate, reason: value.reason };
+}
+function parseCandidatePair(value, subject, param) {
+    if (typeof value.model !== "string" || value.model === "") {
+        throw invalidSelectorRequest(`Selector ${subject} is missing a model name.`, `${param}.model`);
+    }
+    if (!isReasoningEffort(value.thinking_level)) {
+        throw invalidSelectorRequest(`Selector ${subject} has invalid thinking_level: ${String(value.thinking_level)}`, `${param}.thinking_level`);
+    }
+    return { model: value.model, reasoningEffort: value.thinking_level };
+}
+function parseSelectorInput(payload) {
+    if (!isRecord(payload)) {
+        throw invalidSelectorRequest("Selector request must be a JSON object.");
+    }
+    const messages = payload.messages ?? [];
+    if (!Array.isArray(messages)) {
+        throw invalidSelectorRequest("Selector request messages must be an array.", "messages");
+    }
+    const userMessage = messages.find((message) => isRecord(message) && message.role === "user");
+    if (userMessage === undefined) {
+        throw invalidSelectorRequest("Selector request is missing the user message.");
+    }
+    const content = userMessage.content;
+    if (typeof content !== "string") {
+        throw invalidSelectorRequest("Selector request user message content must be a string.");
+    }
+    let parsed;
+    try {
+        parsed = JSON.parse(content);
+    }
+    catch {
+        throw invalidSelectorRequest("Selector request user message is not valid JSON.");
+    }
+    if (!isRecord(parsed)) {
+        throw invalidSelectorRequest("Selector request user message is not a JSON object.");
+    }
+    if (!Array.isArray(parsed.candidate_pairs)) {
+        throw invalidSelectorRequest("Selector input is missing candidate_pairs.");
+    }
+    // Anonymization would silently drop custom rules rather than apply them.
+    if ("custom_rules" in parsed || "default_target" in parsed) {
+        throw new RouterFrameworkError("invalid_request", "The Dari Auto Router serves only the default routing policy and cannot apply " +
+            "custom routing rules. Self-host the selector or use the Dari managed platform " +
+            "for custom routing.", "custom_rules_not_supported");
+    }
+    if (!Array.isArray(parsed.messages)) {
+        throw invalidSelectorRequest("Selector input messages must be an array.", "messages");
+    }
+    for (const [index, message] of parsed.messages.entries()) {
+        if (!isRecord(message) || typeof message.role !== "string") {
+            throw invalidSelectorRequest("Selector input messages must be objects with a string role.", `messages[${index}]`);
+        }
+    }
+    return parsed;
+}
+function invalidSelectorRequest(message, param) {
+    return new RouterFrameworkError("invalid_request", message, "invalid_request_error", param);
+}
+//# sourceMappingURL=selector_wire.js.map

package/dist/selector_wire.js.map

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