@evalops/maestro 0.10.8 → 0.10.11

package/dist/services/compliance/types.d.ts

@@ -0,0 +1,185 @@
+export declare const COMPLIANCE_FRAMEWORKS: readonly ["soc2", "iso27001"];
+export type ComplianceFramework = (typeof COMPLIANCE_FRAMEWORKS)[number];
+export type ComplianceJsonValue = string | number | boolean | null | ComplianceJsonValue[] | {
+    [key: string]: ComplianceJsonValue;
+};
+export interface ComplianceControl {
+    id: string;
+    framework: ComplianceFramework;
+    title: string;
+    description: string;
+    evidenceTypes: string[];
+    mappedActionTypes: string[];
+}
+export interface AgentActionInput {
+    actionId?: string;
+    workspaceId?: string;
+    agentId?: string;
+    type: string;
+    status?: string;
+    timestamp?: Date | string;
+    resource?: string;
+    description?: string;
+    metadata?: Record<string, unknown>;
+}
+export interface AgentActionRecord {
+    actionId: string;
+    workspaceId?: string;
+    agentId?: string;
+    type: string;
+    status: string;
+    timestamp: string;
+    resource?: string;
+    description?: string;
+    metadata: Record<string, ComplianceJsonValue>;
+}
+export interface GovernanceEvaluationInput {
+    evaluationId?: string;
+    workspaceId?: string;
+    agentId?: string;
+    policyId?: string;
+    actionType: string;
+    decision: string;
+    riskLevel?: string;
+    reason?: string;
+    timestamp?: Date | string;
+    metadata?: Record<string, unknown>;
+}
+export interface GovernanceEvaluationRecord {
+    evaluationId: string;
+    workspaceId?: string;
+    agentId?: string;
+    policyId?: string;
+    actionType: string;
+    decision: string;
+    riskLevel?: string;
+    reason?: string;
+    timestamp: string;
+    metadata: Record<string, ComplianceJsonValue>;
+}
+export interface ComplianceEvidence {
+    evidenceId: string;
+    controlId: string;
+    framework: ComplianceFramework;
+    sourceType: string;
+    timestamp: string;
+    summary: string;
+    workspaceId?: string;
+    agentId?: string;
+    actionId?: string;
+    traceId?: string;
+    resource?: string;
+    status?: string;
+    metadata: Record<string, ComplianceJsonValue>;
+}
+export interface ComplianceReportRequest {
+    workspaceId?: string;
+    frameworks?: ComplianceFramework[];
+    from?: Date | string;
+    to?: Date | string;
+    actions?: AgentActionInput[];
+    governanceEvents?: GovernanceEvaluationInput[];
+    includeEvidence?: boolean;
+    includeArtifact?: boolean;
+}
+export interface NormalizedComplianceReportRequest {
+    workspaceId?: string;
+    frameworks: ComplianceFramework[];
+    from?: Date;
+    to?: Date;
+    actions: AgentActionRecord[];
+    governanceEvents: GovernanceEvaluationRecord[];
+    includeEvidence: boolean;
+    includeArtifact: boolean;
+}
+export interface ComplianceControlReport {
+    control: ComplianceControl;
+    status: "satisfied" | "missing";
+    evidenceCount: number;
+    evidence?: ComplianceEvidence[];
+}
+export interface ComplianceArtifactControlMatrixRow {
+    controlId: string;
+    framework: ComplianceFramework;
+    title: string;
+    status: "satisfied" | "missing";
+    evidenceCount: number;
+    evidenceIds: string[];
+    evidenceSources: string[];
+    lastEvidenceAt?: string;
+}
+export interface ComplianceArtifactGap {
+    controlId: string;
+    framework: ComplianceFramework;
+    title: string;
+    severity: "high" | "medium";
+    reason: string;
+    remediation: string;
+}
+export interface ComplianceArtifactSourceManifestEntry {
+    sourceType: string;
+    evidenceCount: number;
+    firstSeenAt?: string;
+    lastSeenAt?: string;
+}
+export interface ComplianceArtifact {
+    artifactId: string;
+    format: "auditor_json";
+    reportId: string;
+    generatedAt: string;
+    workspaceId?: string;
+    period: {
+        from?: string;
+        to?: string;
+    };
+    frameworks: ComplianceFramework[];
+    executiveSummary: string;
+    controlMatrix: ComplianceArtifactControlMatrixRow[];
+    evidenceIndex: ComplianceEvidence[];
+    gaps: ComplianceArtifactGap[];
+    sourceManifest: ComplianceArtifactSourceManifestEntry[];
+    exports: {
+        drata: {
+            controlEvidence: Array<{
+                controlExternalId: string;
+                evidenceIds: string[];
+                status: "ready" | "gap";
+            }>;
+        };
+        vanta: {
+            customEvidence: Array<{
+                controlId: string;
+                title: string;
+                evidenceCount: number;
+            }>;
+        };
+    };
+}
+export interface ComplianceReport {
+    reportId: string;
+    generatedAt: string;
+    workspaceId?: string;
+    period: {
+        from?: string;
+        to?: string;
+    };
+    frameworks: ComplianceFramework[];
+    summary: {
+        controls: number;
+        satisfied: number;
+        missing: number;
+        evidenceItems: number;
+    };
+    controls: ComplianceControlReport[];
+    artifact?: ComplianceArtifact;
+}
+export interface ComplianceEvidenceQuery {
+    workspaceId?: string;
+    from?: Date;
+    to?: Date;
+}
+export interface ComplianceControlEvidence {
+    control: ComplianceControl;
+    evidence: ComplianceEvidence[];
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/services/compliance/types.d.ts.map

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

package/dist/services/compliance/types.js

@@ -0,0 +1,2 @@
+export const COMPLIANCE_FRAMEWORKS = ["soc2", "iso27001"];
+//# sourceMappingURL=types.js.map

package/dist/services/compliance/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/services/compliance/types.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,MAAM,EAAE,UAAU,CAAU,CAAC","sourcesContent":["export const COMPLIANCE_FRAMEWORKS = [\"soc2\", \"iso27001\"] as const;\n\nexport type ComplianceFramework = (typeof COMPLIANCE_FRAMEWORKS)[number];\n\nexport type ComplianceJsonValue =\n\t| string\n\t| number\n\t| boolean\n\t| null\n\t| ComplianceJsonValue[]\n\t| { [key: string]: ComplianceJsonValue };\n\nexport interface ComplianceControl {\n\tid: string;\n\tframework: ComplianceFramework;\n\ttitle: string;\n\tdescription: string;\n\tevidenceTypes: string[];\n\tmappedActionTypes: string[];\n}\n\nexport interface AgentActionInput {\n\tactionId?: string;\n\tworkspaceId?: string;\n\tagentId?: string;\n\ttype: string;\n\tstatus?: string;\n\ttimestamp?: Date | string;\n\tresource?: string;\n\tdescription?: string;\n\tmetadata?: Record<string, unknown>;\n}\n\nexport interface AgentActionRecord {\n\tactionId: string;\n\tworkspaceId?: string;\n\tagentId?: string;\n\ttype: string;\n\tstatus: string;\n\ttimestamp: string;\n\tresource?: string;\n\tdescription?: string;\n\tmetadata: Record<string, ComplianceJsonValue>;\n}\n\nexport interface GovernanceEvaluationInput {\n\tevaluationId?: string;\n\tworkspaceId?: string;\n\tagentId?: string;\n\tpolicyId?: string;\n\tactionType: string;\n\tdecision: string;\n\triskLevel?: string;\n\treason?: string;\n\ttimestamp?: Date | string;\n\tmetadata?: Record<string, unknown>;\n}\n\nexport interface GovernanceEvaluationRecord {\n\tevaluationId: string;\n\tworkspaceId?: string;\n\tagentId?: string;\n\tpolicyId?: string;\n\tactionType: string;\n\tdecision: string;\n\triskLevel?: string;\n\treason?: string;\n\ttimestamp: string;\n\tmetadata: Record<string, ComplianceJsonValue>;\n}\n\nexport interface ComplianceEvidence {\n\tevidenceId: string;\n\tcontrolId: string;\n\tframework: ComplianceFramework;\n\tsourceType: string;\n\ttimestamp: string;\n\tsummary: string;\n\tworkspaceId?: string;\n\tagentId?: string;\n\tactionId?: string;\n\ttraceId?: string;\n\tresource?: string;\n\tstatus?: string;\n\tmetadata: Record<string, ComplianceJsonValue>;\n}\n\nexport interface ComplianceReportRequest {\n\tworkspaceId?: string;\n\tframeworks?: ComplianceFramework[];\n\tfrom?: Date | string;\n\tto?: Date | string;\n\tactions?: AgentActionInput[];\n\tgovernanceEvents?: GovernanceEvaluationInput[];\n\tincludeEvidence?: boolean;\n\tincludeArtifact?: boolean;\n}\n\nexport interface NormalizedComplianceReportRequest {\n\tworkspaceId?: string;\n\tframeworks: ComplianceFramework[];\n\tfrom?: Date;\n\tto?: Date;\n\tactions: AgentActionRecord[];\n\tgovernanceEvents: GovernanceEvaluationRecord[];\n\tincludeEvidence: boolean;\n\tincludeArtifact: boolean;\n}\n\nexport interface ComplianceControlReport {\n\tcontrol: ComplianceControl;\n\tstatus: \"satisfied\" | \"missing\";\n\tevidenceCount: number;\n\tevidence?: ComplianceEvidence[];\n}\n\nexport interface ComplianceArtifactControlMatrixRow {\n\tcontrolId: string;\n\tframework: ComplianceFramework;\n\ttitle: string;\n\tstatus: \"satisfied\" | \"missing\";\n\tevidenceCount: number;\n\tevidenceIds: string[];\n\tevidenceSources: string[];\n\tlastEvidenceAt?: string;\n}\n\nexport interface ComplianceArtifactGap {\n\tcontrolId: string;\n\tframework: ComplianceFramework;\n\ttitle: string;\n\tseverity: \"high\" | \"medium\";\n\treason: string;\n\tremediation: string;\n}\n\nexport interface ComplianceArtifactSourceManifestEntry {\n\tsourceType: string;\n\tevidenceCount: number;\n\tfirstSeenAt?: string;\n\tlastSeenAt?: string;\n}\n\nexport interface ComplianceArtifact {\n\tartifactId: string;\n\tformat: \"auditor_json\";\n\treportId: string;\n\tgeneratedAt: string;\n\tworkspaceId?: string;\n\tperiod: {\n\t\tfrom?: string;\n\t\tto?: string;\n\t};\n\tframeworks: ComplianceFramework[];\n\texecutiveSummary: string;\n\tcontrolMatrix: ComplianceArtifactControlMatrixRow[];\n\tevidenceIndex: ComplianceEvidence[];\n\tgaps: ComplianceArtifactGap[];\n\tsourceManifest: ComplianceArtifactSourceManifestEntry[];\n\texports: {\n\t\tdrata: {\n\t\t\tcontrolEvidence: Array<{\n\t\t\t\tcontrolExternalId: string;\n\t\t\t\tevidenceIds: string[];\n\t\t\t\tstatus: \"ready\" | \"gap\";\n\t\t\t}>;\n\t\t};\n\t\tvanta: {\n\t\t\tcustomEvidence: Array<{\n\t\t\t\tcontrolId: string;\n\t\t\t\ttitle: string;\n\t\t\t\tevidenceCount: number;\n\t\t\t}>;\n\t\t};\n\t};\n}\n\nexport interface ComplianceReport {\n\treportId: string;\n\tgeneratedAt: string;\n\tworkspaceId?: string;\n\tperiod: {\n\t\tfrom?: string;\n\t\tto?: string;\n\t};\n\tframeworks: ComplianceFramework[];\n\tsummary: {\n\t\tcontrols: number;\n\t\tsatisfied: number;\n\t\tmissing: number;\n\t\tevidenceItems: number;\n\t};\n\tcontrols: ComplianceControlReport[];\n\tartifact?: ComplianceArtifact;\n}\n\nexport interface ComplianceEvidenceQuery {\n\tworkspaceId?: string;\n\tfrom?: Date;\n\tto?: Date;\n}\n\nexport interface ComplianceControlEvidence {\n\tcontrol: ComplianceControl;\n\tevidence: ComplianceEvidence[];\n}\n"]}

package/dist/services/intelligent-router/index.d.ts

@@ -0,0 +1,5 @@
+export { IntelligentRouterValidationError, normalizePerformanceMetricInput, normalizeRoutingOverrideInput, normalizeRoutingRequest, parseRoutingStrategy, } from "./normalize.js";
+export { recordIntelligentRouterChatMetric, registeredRoutingModels, resolveIntelligentRouterStrategy, resolveIntelligentRouterTaskType, selectIntelligentRouterModel, } from "./recorder.js";
+export { IntelligentRouterService, getIntelligentRouterService, setIntelligentRouterServiceForTest, } from "./service.js";
+export { ROUTING_STRATEGIES, type ModelPerformanceAggregate, type ModelPerformanceMetricInput, type RoutedModel, type RoutingDecision, type RoutingModelCandidate, type RoutingModelCost, type RoutingOverride, type RoutingOverrideInput, type RoutingRequest, type RoutingRequestInput, type RoutingScore, type RoutingStrategy, } from "./types.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/services/intelligent-router/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/services/intelligent-router/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACN,gCAAgC,EAChC,+BAA+B,EAC/B,6BAA6B,EAC7B,uBAAuB,EACvB,oBAAoB,GACpB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACN,iCAAiC,EACjC,uBAAuB,EACvB,gCAAgC,EAChC,gCAAgC,EAChC,4BAA4B,GAC5B,MAAM,eAAe,CAAC;AACvB,OAAO,EACN,wBAAwB,EACxB,2BAA2B,EAC3B,kCAAkC,GAClC,MAAM,cAAc,CAAC;AACtB,OAAO,EACN,kBAAkB,EAClB,KAAK,yBAAyB,EAC9B,KAAK,2BAA2B,EAChC,KAAK,WAAW,EAChB,KAAK,eAAe,EACpB,KAAK,qBAAqB,EAC1B,KAAK,gBAAgB,EACrB,KAAK,eAAe,EACpB,KAAK,oBAAoB,EACzB,KAAK,cAAc,EACnB,KAAK,mBAAmB,EACxB,KAAK,YAAY,EACjB,KAAK,eAAe,GACpB,MAAM,YAAY,CAAC"}

package/dist/services/intelligent-router/index.js

@@ -0,0 +1,5 @@
+export { IntelligentRouterValidationError, normalizePerformanceMetricInput, normalizeRoutingOverrideInput, normalizeRoutingRequest, parseRoutingStrategy, } from "./normalize.js";
+export { recordIntelligentRouterChatMetric, registeredRoutingModels, resolveIntelligentRouterStrategy, resolveIntelligentRouterTaskType, selectIntelligentRouterModel, } from "./recorder.js";
+export { IntelligentRouterService, getIntelligentRouterService, setIntelligentRouterServiceForTest, } from "./service.js";
+export { ROUTING_STRATEGIES, } from "./types.js";
+//# sourceMappingURL=index.js.map

package/dist/services/intelligent-router/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/services/intelligent-router/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACN,gCAAgC,EAChC,+BAA+B,EAC/B,6BAA6B,EAC7B,uBAAuB,EACvB,oBAAoB,GACpB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACN,iCAAiC,EACjC,uBAAuB,EACvB,gCAAgC,EAChC,gCAAgC,EAChC,4BAA4B,GAC5B,MAAM,eAAe,CAAC;AACvB,OAAO,EACN,wBAAwB,EACxB,2BAA2B,EAC3B,kCAAkC,GAClC,MAAM,cAAc,CAAC;AACtB,OAAO,EACN,kBAAkB,GAalB,MAAM,YAAY,CAAC","sourcesContent":["export {\n\tIntelligentRouterValidationError,\n\tnormalizePerformanceMetricInput,\n\tnormalizeRoutingOverrideInput,\n\tnormalizeRoutingRequest,\n\tparseRoutingStrategy,\n} from \"./normalize.js\";\nexport {\n\trecordIntelligentRouterChatMetric,\n\tregisteredRoutingModels,\n\tresolveIntelligentRouterStrategy,\n\tresolveIntelligentRouterTaskType,\n\tselectIntelligentRouterModel,\n} from \"./recorder.js\";\nexport {\n\tIntelligentRouterService,\n\tgetIntelligentRouterService,\n\tsetIntelligentRouterServiceForTest,\n} from \"./service.js\";\nexport {\n\tROUTING_STRATEGIES,\n\ttype ModelPerformanceAggregate,\n\ttype ModelPerformanceMetricInput,\n\ttype RoutedModel,\n\ttype RoutingDecision,\n\ttype RoutingModelCandidate,\n\ttype RoutingModelCost,\n\ttype RoutingOverride,\n\ttype RoutingOverrideInput,\n\ttype RoutingRequest,\n\ttype RoutingRequestInput,\n\ttype RoutingScore,\n\ttype RoutingStrategy,\n} from \"./types.js\";\n"]}

package/dist/services/intelligent-router/normalize.d.ts

@@ -0,0 +1,9 @@
+import { type ModelPerformanceMetricInput, type RoutingModelCandidate, type RoutingOverrideInput, type RoutingRequest, type RoutingRequestInput, type RoutingStrategy } from "./types.js";
+export declare class IntelligentRouterValidationError extends Error {
+    constructor(message: string);
+}
+export declare function parseRoutingStrategy(value: unknown): RoutingStrategy;
+export declare function normalizeRoutingRequest(input: RoutingRequestInput, defaultAvailableModels: RoutingModelCandidate[]): RoutingRequest;
+export declare function normalizePerformanceMetricInput(input: ModelPerformanceMetricInput): Required<ModelPerformanceMetricInput>;
+export declare function normalizeRoutingOverrideInput(input: RoutingOverrideInput): RoutingOverrideInput;
+//# sourceMappingURL=normalize.d.ts.map

package/dist/services/intelligent-router/normalize.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"normalize.d.ts","sourceRoot":"","sources":["../../../src/services/intelligent-router/normalize.ts"],"names":[],"mappings":"AAAA,OAAO,EACN,KAAK,2BAA2B,EAEhC,KAAK,qBAAqB,EAC1B,KAAK,oBAAoB,EACzB,KAAK,cAAc,EACnB,KAAK,mBAAmB,EACxB,KAAK,eAAe,EACpB,MAAM,YAAY,CAAC;AAEpB,qBAAa,gCAAiC,SAAQ,KAAK;gBAC9C,OAAO,EAAE,MAAM;CAI3B;AAmDD,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,OAAO,GAAG,eAAe,CAQpE;AA4DD,wBAAgB,uBAAuB,CACtC,KAAK,EAAE,mBAAmB,EAC1B,sBAAsB,EAAE,qBAAqB,EAAE,GAC7C,cAAc,CAyBhB;AAED,wBAAgB,+BAA+B,CAC9C,KAAK,EAAE,2BAA2B,GAChC,QAAQ,CAAC,2BAA2B,CAAC,CA0BvC;AAED,wBAAgB,6BAA6B,CAC5C,KAAK,EAAE,oBAAoB,GACzB,oBAAoB,CActB"}

package/dist/services/intelligent-router/normalize.js

@@ -0,0 +1,169 @@
+import { ROUTING_STRATEGIES, } from "./types.js";
+export class IntelligentRouterValidationError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "IntelligentRouterValidationError";
+    }
+}
+function isRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function cleanOptionalString(value) {
+    if (typeof value !== "string")
+        return undefined;
+    const trimmed = value.trim();
+    return trimmed ? trimmed : undefined;
+}
+function cleanRequiredString(value, label) {
+    const trimmed = cleanOptionalString(value);
+    if (!trimmed) {
+        throw new IntelligentRouterValidationError(`${label} is required.`);
+    }
+    return trimmed;
+}
+function parseFiniteNumber(value, label) {
+    if (value === undefined || value === null || value === "")
+        return undefined;
+    const parsed = typeof value === "number" ? value : Number(value);
+    if (!Number.isFinite(parsed)) {
+        throw new IntelligentRouterValidationError(`${label} must be a number.`);
+    }
+    return parsed;
+}
+function parseOptionalBoolean(value) {
+    if (value === undefined || value === null || value === "")
+        return undefined;
+    if (typeof value === "boolean")
+        return value;
+    if (typeof value === "string") {
+        const normalized = value.trim().toLowerCase();
+        if (normalized === "true")
+            return true;
+        if (normalized === "false")
+            return false;
+    }
+    throw new IntelligentRouterValidationError("success must be a boolean.");
+}
+function parseOptionalDate(value, label) {
+    if (value === undefined || value === null || value === "")
+        return undefined;
+    const parsed = value instanceof Date ? value : new Date(String(value));
+    if (Number.isNaN(parsed.getTime())) {
+        throw new IntelligentRouterValidationError(`${label} must be a valid date.`);
+    }
+    return parsed;
+}
+export function parseRoutingStrategy(value) {
+    const normalized = cleanOptionalString(value)?.toLowerCase() ?? "balanced";
+    if (ROUTING_STRATEGIES.includes(normalized)) {
+        return normalized;
+    }
+    throw new IntelligentRouterValidationError("Invalid routing strategy. Use balanced, quality, cost, or latency.");
+}
+function normalizeUnavailableModels(value) {
+    if (value === undefined || value === null)
+        return [];
+    if (typeof value === "string") {
+        return value
+            .split(",")
+            .map((entry) => entry.trim())
+            .filter(Boolean);
+    }
+    if (!Array.isArray(value)) {
+        throw new IntelligentRouterValidationError("unavailableModels must be an array or comma-separated string.");
+    }
+    return value.map((entry) => String(entry).trim()).filter(Boolean);
+}
+function normalizeAvailableModels(value) {
+    if (value === undefined || value === null)
+        return [];
+    if (!Array.isArray(value)) {
+        throw new IntelligentRouterValidationError("availableModels must be an array.");
+    }
+    return value.filter(isRecord).map((entry) => {
+        const provider = cleanRequiredString(entry.provider, "provider");
+        const model = cleanRequiredString(entry.model, "model");
+        const name = cleanOptionalString(entry.name);
+        const available = typeof entry.available === "boolean" ? entry.available : undefined;
+        const cost = (() => {
+            if (!isRecord(entry.cost))
+                return undefined;
+            const input = parseFiniteNumber(entry.cost.input, "cost.input");
+            const output = parseFiniteNumber(entry.cost.output, "cost.output");
+            const cacheRead = parseFiniteNumber(entry.cost.cacheRead, "cost.cacheRead");
+            const cacheWrite = parseFiniteNumber(entry.cost.cacheWrite, "cost.cacheWrite");
+            return {
+                ...(input !== undefined ? { input } : {}),
+                ...(output !== undefined ? { output } : {}),
+                ...(cacheRead !== undefined ? { cacheRead } : {}),
+                ...(cacheWrite !== undefined ? { cacheWrite } : {}),
+            };
+        })();
+        return {
+            provider,
+            model,
+            ...(name ? { name } : {}),
+            ...(cost && Object.keys(cost).length > 0 ? { cost } : {}),
+            ...(available !== undefined ? { available } : {}),
+        };
+    });
+}
+export function normalizeRoutingRequest(input, defaultAvailableModels) {
+    if (!isRecord(input)) {
+        throw new IntelligentRouterValidationError("Routing request must be an object.");
+    }
+    const requestInput = input;
+    const taskType = cleanOptionalString(requestInput.taskType) ?? "chat";
+    const modelHint = cleanOptionalString(requestInput.modelHint) ??
+        cleanOptionalString(requestInput.model_hint);
+    const unavailableModels = normalizeUnavailableModels(requestInput.unavailableModels ?? requestInput.unavailable_models);
+    const availableModels = normalizeAvailableModels(requestInput.availableModels);
+    return {
+        taskType,
+        strategy: parseRoutingStrategy(requestInput.strategy),
+        unavailableModels,
+        availableModels: availableModels.length > 0 ? availableModels : defaultAvailableModels,
+        ...(modelHint ? { modelHint } : {}),
+    };
+}
+export function normalizePerformanceMetricInput(input) {
+    if (!isRecord(input)) {
+        throw new IntelligentRouterValidationError("Metric must be an object.");
+    }
+    const metricInput = input;
+    const latencyMs = parseFiniteNumber(metricInput.latencyMs, "latencyMs") ?? 0;
+    const costUsd = parseFiniteNumber(metricInput.costUsd, "costUsd") ?? 0;
+    const qualityScore = parseFiniteNumber(metricInput.qualityScore, "qualityScore") ?? 0.5;
+    if (latencyMs < 0) {
+        throw new IntelligentRouterValidationError("latencyMs cannot be negative.");
+    }
+    if (costUsd < 0) {
+        throw new IntelligentRouterValidationError("costUsd cannot be negative.");
+    }
+    return {
+        taskType: cleanRequiredString(metricInput.taskType, "taskType"),
+        provider: cleanRequiredString(metricInput.provider, "provider"),
+        model: cleanRequiredString(metricInput.model, "model"),
+        latencyMs,
+        success: parseOptionalBoolean(metricInput.success) ?? true,
+        costUsd,
+        qualityScore: Math.max(0, Math.min(1, qualityScore)),
+        occurredAt: parseOptionalDate(metricInput.occurredAt, "occurredAt") ?? new Date(),
+    };
+}
+export function normalizeRoutingOverrideInput(input) {
+    if (!isRecord(input)) {
+        throw new IntelligentRouterValidationError("Override must be an object.");
+    }
+    const overrideInput = input;
+    const reason = cleanOptionalString(overrideInput.reason);
+    const expiresAt = parseOptionalDate(overrideInput.expiresAt, "expiresAt");
+    return {
+        taskType: cleanRequiredString(overrideInput.taskType, "taskType"),
+        provider: cleanRequiredString(overrideInput.provider, "provider"),
+        model: cleanRequiredString(overrideInput.model, "model"),
+        ...(reason ? { reason } : {}),
+        ...(expiresAt ? { expiresAt } : {}),
+    };
+}
+//# sourceMappingURL=normalize.js.map

package/dist/services/intelligent-router/normalize.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"normalize.js","sourceRoot":"","sources":["../../../src/services/intelligent-router/normalize.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n\ttype ModelPerformanceMetricInput,\n\tROUTING_STRATEGIES,\n\ttype RoutingModelCandidate,\n\ttype RoutingOverrideInput,\n\ttype RoutingRequest,\n\ttype RoutingRequestInput,\n\ttype RoutingStrategy,\n} from \"./types.js\";\n\nexport class IntelligentRouterValidationError extends Error {\n\tconstructor(message: string) {\n\t\tsuper(message);\n\t\tthis.name = \"IntelligentRouterValidationError\";\n\t}\n}\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n\treturn typeof value === \"object\" && value !== null && !Array.isArray(value);\n}\n\nfunction cleanOptionalString(value: unknown): string | undefined {\n\tif (typeof value !== \"string\") return undefined;\n\tconst trimmed = value.trim();\n\treturn trimmed ? trimmed : undefined;\n}\n\nfunction cleanRequiredString(value: unknown, label: string): string {\n\tconst trimmed = cleanOptionalString(value);\n\tif (!trimmed) {\n\t\tthrow new IntelligentRouterValidationError(`${label} is required.`);\n\t}\n\treturn trimmed;\n}\n\nfunction parseFiniteNumber(value: unknown, label: string): number | undefined {\n\tif (value === undefined || value === null || value === \"\") return undefined;\n\tconst parsed = typeof value === \"number\" ? value : Number(value);\n\tif (!Number.isFinite(parsed)) {\n\t\tthrow new IntelligentRouterValidationError(`${label} must be a number.`);\n\t}\n\treturn parsed;\n}\n\nfunction parseOptionalBoolean(value: unknown): boolean | undefined {\n\tif (value === undefined || value === null || value === \"\") return undefined;\n\tif (typeof value === \"boolean\") return value;\n\tif (typeof value === \"string\") {\n\t\tconst normalized = value.trim().toLowerCase();\n\t\tif (normalized === \"true\") return true;\n\t\tif (normalized === \"false\") return false;\n\t}\n\tthrow new IntelligentRouterValidationError(\"success must be a boolean.\");\n}\n\nfunction parseOptionalDate(value: unknown, label: string): Date | undefined {\n\tif (value === undefined || value === null || value === \"\") return undefined;\n\tconst parsed = value instanceof Date ? value : new Date(String(value));\n\tif (Number.isNaN(parsed.getTime())) {\n\t\tthrow new IntelligentRouterValidationError(\n\t\t\t`${label} must be a valid date.`,\n\t\t);\n\t}\n\treturn parsed;\n}\n\nexport function parseRoutingStrategy(value: unknown): RoutingStrategy {\n\tconst normalized = cleanOptionalString(value)?.toLowerCase() ?? \"balanced\";\n\tif (ROUTING_STRATEGIES.includes(normalized as RoutingStrategy)) {\n\t\treturn normalized as RoutingStrategy;\n\t}\n\tthrow new IntelligentRouterValidationError(\n\t\t\"Invalid routing strategy. Use balanced, quality, cost, or latency.\",\n\t);\n}\n\nfunction normalizeUnavailableModels(value: unknown): string[] {\n\tif (value === undefined || value === null) return [];\n\tif (typeof value === \"string\") {\n\t\treturn value\n\t\t\t.split(\",\")\n\t\t\t.map((entry) => entry.trim())\n\t\t\t.filter(Boolean);\n\t}\n\tif (!Array.isArray(value)) {\n\t\tthrow new IntelligentRouterValidationError(\n\t\t\t\"unavailableModels must be an array or comma-separated string.\",\n\t\t);\n\t}\n\treturn value.map((entry) => String(entry).trim()).filter(Boolean);\n}\n\nfunction normalizeAvailableModels(value: unknown): RoutingModelCandidate[] {\n\tif (value === undefined || value === null) return [];\n\tif (!Array.isArray(value)) {\n\t\tthrow new IntelligentRouterValidationError(\n\t\t\t\"availableModels must be an array.\",\n\t\t);\n\t}\n\treturn value.filter(isRecord).map((entry) => {\n\t\tconst provider = cleanRequiredString(entry.provider, \"provider\");\n\t\tconst model = cleanRequiredString(entry.model, \"model\");\n\t\tconst name = cleanOptionalString(entry.name);\n\t\tconst available =\n\t\t\ttypeof entry.available === \"boolean\" ? entry.available : undefined;\n\t\tconst cost = (() => {\n\t\t\tif (!isRecord(entry.cost)) return undefined;\n\t\t\tconst input = parseFiniteNumber(entry.cost.input, \"cost.input\");\n\t\t\tconst output = parseFiniteNumber(entry.cost.output, \"cost.output\");\n\t\t\tconst cacheRead = parseFiniteNumber(\n\t\t\t\tentry.cost.cacheRead,\n\t\t\t\t\"cost.cacheRead\",\n\t\t\t);\n\t\t\tconst cacheWrite = parseFiniteNumber(\n\t\t\t\tentry.cost.cacheWrite,\n\t\t\t\t\"cost.cacheWrite\",\n\t\t\t);\n\t\t\treturn {\n\t\t\t\t...(input !== undefined ? { input } : {}),\n\t\t\t\t...(output !== undefined ? { output } : {}),\n\t\t\t\t...(cacheRead !== undefined ? { cacheRead } : {}),\n\t\t\t\t...(cacheWrite !== undefined ? { cacheWrite } : {}),\n\t\t\t};\n\t\t})();\n\t\treturn {\n\t\t\tprovider,\n\t\t\tmodel,\n\t\t\t...(name ? { name } : {}),\n\t\t\t...(cost && Object.keys(cost).length > 0 ? { cost } : {}),\n\t\t\t...(available !== undefined ? { available } : {}),\n\t\t};\n\t});\n}\n\nexport function normalizeRoutingRequest(\n\tinput: RoutingRequestInput,\n\tdefaultAvailableModels: RoutingModelCandidate[],\n): RoutingRequest {\n\tif (!isRecord(input)) {\n\t\tthrow new IntelligentRouterValidationError(\n\t\t\t\"Routing request must be an object.\",\n\t\t);\n\t}\n\tconst requestInput = input as RoutingRequestInput;\n\tconst taskType = cleanOptionalString(requestInput.taskType) ?? \"chat\";\n\tconst modelHint =\n\t\tcleanOptionalString(requestInput.modelHint) ??\n\t\tcleanOptionalString(requestInput.model_hint);\n\tconst unavailableModels = normalizeUnavailableModels(\n\t\trequestInput.unavailableModels ?? requestInput.unavailable_models,\n\t);\n\tconst availableModels = normalizeAvailableModels(\n\t\trequestInput.availableModels,\n\t);\n\treturn {\n\t\ttaskType,\n\t\tstrategy: parseRoutingStrategy(requestInput.strategy),\n\t\tunavailableModels,\n\t\tavailableModels:\n\t\t\tavailableModels.length > 0 ? availableModels : defaultAvailableModels,\n\t\t...(modelHint ? { modelHint } : {}),\n\t};\n}\n\nexport function normalizePerformanceMetricInput(\n\tinput: ModelPerformanceMetricInput,\n): Required<ModelPerformanceMetricInput> {\n\tif (!isRecord(input)) {\n\t\tthrow new IntelligentRouterValidationError(\"Metric must be an object.\");\n\t}\n\tconst metricInput = input as ModelPerformanceMetricInput;\n\tconst latencyMs = parseFiniteNumber(metricInput.latencyMs, \"latencyMs\") ?? 0;\n\tconst costUsd = parseFiniteNumber(metricInput.costUsd, \"costUsd\") ?? 0;\n\tconst qualityScore =\n\t\tparseFiniteNumber(metricInput.qualityScore, \"qualityScore\") ?? 0.5;\n\tif (latencyMs < 0) {\n\t\tthrow new IntelligentRouterValidationError(\"latencyMs cannot be negative.\");\n\t}\n\tif (costUsd < 0) {\n\t\tthrow new IntelligentRouterValidationError(\"costUsd cannot be negative.\");\n\t}\n\treturn {\n\t\ttaskType: cleanRequiredString(metricInput.taskType, \"taskType\"),\n\t\tprovider: cleanRequiredString(metricInput.provider, \"provider\"),\n\t\tmodel: cleanRequiredString(metricInput.model, \"model\"),\n\t\tlatencyMs,\n\t\tsuccess: parseOptionalBoolean(metricInput.success) ?? true,\n\t\tcostUsd,\n\t\tqualityScore: Math.max(0, Math.min(1, qualityScore)),\n\t\toccurredAt:\n\t\t\tparseOptionalDate(metricInput.occurredAt, \"occurredAt\") ?? new Date(),\n\t};\n}\n\nexport function normalizeRoutingOverrideInput(\n\tinput: RoutingOverrideInput,\n): RoutingOverrideInput {\n\tif (!isRecord(input)) {\n\t\tthrow new IntelligentRouterValidationError(\"Override must be an object.\");\n\t}\n\tconst overrideInput = input as RoutingOverrideInput;\n\tconst reason = cleanOptionalString(overrideInput.reason);\n\tconst expiresAt = parseOptionalDate(overrideInput.expiresAt, \"expiresAt\");\n\treturn {\n\t\ttaskType: cleanRequiredString(overrideInput.taskType, \"taskType\"),\n\t\tprovider: cleanRequiredString(overrideInput.provider, \"provider\"),\n\t\tmodel: cleanRequiredString(overrideInput.model, \"model\"),\n\t\t...(reason ? { reason } : {}),\n\t\t...(expiresAt ? { expiresAt } : {}),\n\t};\n}\n"]}

package/dist/services/intelligent-router/recorder.d.ts

@@ -0,0 +1,24 @@
+import type { IncomingMessage } from "node:http";
+import type { AssistantMessage } from "../../agent/types.js";
+import type { RoutingDecision, RoutingModelCandidate, RoutingStrategy } from "./types.js";
+export interface RoutedModelSelection {
+    taskType: string;
+    decision: RoutingDecision;
+    modelInputs: string[];
+}
+export declare function registeredRoutingModels(): RoutingModelCandidate[];
+export declare function resolveIntelligentRouterTaskType(req: IncomingMessage, body?: unknown): string;
+export declare function resolveIntelligentRouterStrategy(req: IncomingMessage): RoutingStrategy | undefined;
+export declare function selectIntelligentRouterModel(params: {
+    req: IncomingMessage;
+    requestedModel?: string | null;
+    body?: unknown;
+}): RoutedModelSelection;
+export declare function recordIntelligentRouterChatMetric(params: {
+    taskType: string;
+    provider: string;
+    model: string;
+    startedAt: number;
+    message: AssistantMessage;
+}): void;
+//# sourceMappingURL=recorder.d.ts.map

package/dist/services/intelligent-router/recorder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"recorder.d.ts","sourceRoot":"","sources":["../../../src/services/intelligent-router/recorder.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AACjD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAK7D,OAAO,KAAK,EAEX,eAAe,EACf,qBAAqB,EACrB,eAAe,EACf,MAAM,YAAY,CAAC;AAIpB,MAAM,WAAW,oBAAoB;IACpC,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,eAAe,CAAC;IAC1B,WAAW,EAAE,MAAM,EAAE,CAAC;CACtB;AAmBD,wBAAgB,uBAAuB,IAAI,qBAAqB,EAAE,CAQjE;AAED,wBAAgB,gCAAgC,CAC/C,GAAG,EAAE,eAAe,EACpB,IAAI,CAAC,EAAE,OAAO,GACZ,MAAM,CAaR;AAED,wBAAgB,gCAAgC,CAC/C,GAAG,EAAE,eAAe,GAClB,eAAe,GAAG,SAAS,CAU7B;AAED,wBAAgB,4BAA4B,CAAC,MAAM,EAAE;IACpD,GAAG,EAAE,eAAe,CAAC;IACrB,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,IAAI,CAAC,EAAE,OAAO,CAAC;CACf,GAAG,oBAAoB,CAkBvB;AAED,wBAAgB,iCAAiC,CAAC,MAAM,EAAE;IACzD,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,gBAAgB,CAAC;CAC1B,GAAG,IAAI,CAuBP"}

package/dist/services/intelligent-router/recorder.js

@@ -0,0 +1,98 @@
+import { getRegisteredModels } from "../../models/registry.js";
+import { createLogger } from "../../utils/logger.js";
+import { getIntelligentRouterService } from "./service.js";
+import { ROUTING_STRATEGIES } from "./types.js";
+const logger = createLogger("intelligent-router:recorder");
+function modelInput(model) {
+    return `${model.provider}/${model.model}`;
+}
+function firstHeader(req, names) {
+    for (const name of names) {
+        const raw = req.headers[name.toLowerCase()];
+        const value = Array.isArray(raw) ? raw[0] : raw;
+        const trimmed = value?.trim();
+        if (trimmed)
+            return trimmed;
+    }
+    return undefined;
+}
+export function registeredRoutingModels() {
+    return getRegisteredModels().map((model) => ({
+        provider: model.provider,
+        model: model.id,
+        name: model.name || model.id,
+        cost: model.cost,
+        available: true,
+    }));
+}
+export function resolveIntelligentRouterTaskType(req, body) {
+    const header = firstHeader(req, [
+        "x-maestro-task-type",
+        "x-composer-task-type",
+    ]);
+    if (header?.trim())
+        return header.trim();
+    if (body && typeof body === "object" && "taskType" in body) {
+        const taskType = body.taskType;
+        if (typeof taskType === "string" && taskType.trim()) {
+            return taskType.trim();
+        }
+    }
+    return "chat";
+}
+export function resolveIntelligentRouterStrategy(req) {
+    const header = firstHeader(req, [
+        "x-maestro-routing-strategy",
+        "x-composer-routing-strategy",
+    ]);
+    if (!header?.trim())
+        return undefined;
+    const strategy = header.trim().toLowerCase();
+    return ROUTING_STRATEGIES.includes(strategy)
+        ? strategy
+        : undefined;
+}
+export function selectIntelligentRouterModel(params) {
+    const taskType = resolveIntelligentRouterTaskType(params.req, params.body);
+    const modelHint = params.requestedModel ?? undefined;
+    const strategy = resolveIntelligentRouterStrategy(params.req);
+    const decision = getIntelligentRouterService().routeRequest({
+        taskType,
+        availableModels: registeredRoutingModels(),
+        ...(modelHint ? { modelHint } : {}),
+        ...(strategy ? { strategy } : {}),
+    });
+    return {
+        taskType,
+        decision,
+        modelInputs: [
+            modelInput(decision.selectedModel),
+            ...decision.fallbackChain.map(modelInput),
+        ],
+    };
+}
+export function recordIntelligentRouterChatMetric(params) {
+    const usage = params.message.usage;
+    void Promise.resolve()
+        .then(() => {
+        const costUsd = usage.cost?.total;
+        getIntelligentRouterService().recordPerformanceMetric({
+            taskType: params.taskType,
+            provider: params.provider,
+            model: params.model,
+            latencyMs: Date.now() - params.startedAt,
+            success: params.message.stopReason !== "error",
+            occurredAt: new Date(params.message.timestamp),
+            ...(typeof costUsd === "number" ? { costUsd } : {}),
+        });
+    })
+        .catch((error) => {
+        logger.warn("Intelligent router metric recording failed", {
+            error: error instanceof Error ? error.message : String(error),
+            taskType: params.taskType,
+            provider: params.provider,
+            model: params.model,
+        });
+    });
+}
+//# sourceMappingURL=recorder.js.map

package/dist/services/intelligent-router/recorder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"recorder.js","sourceRoot":"","sources":["../../../src/services/intelligent-router/recorder.ts"],"names":[],"mappings":"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","sourcesContent":["import type { IncomingMessage } from \"node:http\";\nimport type { AssistantMessage } from \"../../agent/types.js\";\nimport { getRegisteredModels } from \"../../models/registry.js\";\nimport { createLogger } from \"../../utils/logger.js\";\nimport { getIntelligentRouterService } from \"./service.js\";\nimport { ROUTING_STRATEGIES } from \"./types.js\";\nimport type {\n\tRoutedModel,\n\tRoutingDecision,\n\tRoutingModelCandidate,\n\tRoutingStrategy,\n} from \"./types.js\";\n\nconst logger = createLogger(\"intelligent-router:recorder\");\n\nexport interface RoutedModelSelection {\n\ttaskType: string;\n\tdecision: RoutingDecision;\n\tmodelInputs: string[];\n}\n\nfunction modelInput(model: RoutedModel): string {\n\treturn `${model.provider}/${model.model}`;\n}\n\nfunction firstHeader(\n\treq: IncomingMessage,\n\tnames: string[],\n): string | undefined {\n\tfor (const name of names) {\n\t\tconst raw = req.headers[name.toLowerCase()];\n\t\tconst value = Array.isArray(raw) ? raw[0] : raw;\n\t\tconst trimmed = value?.trim();\n\t\tif (trimmed) return trimmed;\n\t}\n\treturn undefined;\n}\n\nexport function registeredRoutingModels(): RoutingModelCandidate[] {\n\treturn getRegisteredModels().map((model) => ({\n\t\tprovider: model.provider,\n\t\tmodel: model.id,\n\t\tname: model.name || model.id,\n\t\tcost: model.cost,\n\t\tavailable: true,\n\t}));\n}\n\nexport function resolveIntelligentRouterTaskType(\n\treq: IncomingMessage,\n\tbody?: unknown,\n): string {\n\tconst header = firstHeader(req, [\n\t\t\"x-maestro-task-type\",\n\t\t\"x-composer-task-type\",\n\t]);\n\tif (header?.trim()) return header.trim();\n\tif (body && typeof body === \"object\" && \"taskType\" in body) {\n\t\tconst taskType = (body as { taskType?: unknown }).taskType;\n\t\tif (typeof taskType === \"string\" && taskType.trim()) {\n\t\t\treturn taskType.trim();\n\t\t}\n\t}\n\treturn \"chat\";\n}\n\nexport function resolveIntelligentRouterStrategy(\n\treq: IncomingMessage,\n): RoutingStrategy | undefined {\n\tconst header = firstHeader(req, [\n\t\t\"x-maestro-routing-strategy\",\n\t\t\"x-composer-routing-strategy\",\n\t]);\n\tif (!header?.trim()) return undefined;\n\tconst strategy = header.trim().toLowerCase();\n\treturn ROUTING_STRATEGIES.includes(strategy as RoutingStrategy)\n\t\t? (strategy as RoutingStrategy)\n\t\t: undefined;\n}\n\nexport function selectIntelligentRouterModel(params: {\n\treq: IncomingMessage;\n\trequestedModel?: string | null;\n\tbody?: unknown;\n}): RoutedModelSelection {\n\tconst taskType = resolveIntelligentRouterTaskType(params.req, params.body);\n\tconst modelHint = params.requestedModel ?? undefined;\n\tconst strategy = resolveIntelligentRouterStrategy(params.req);\n\tconst decision = getIntelligentRouterService().routeRequest({\n\t\ttaskType,\n\t\tavailableModels: registeredRoutingModels(),\n\t\t...(modelHint ? { modelHint } : {}),\n\t\t...(strategy ? { strategy } : {}),\n\t});\n\treturn {\n\t\ttaskType,\n\t\tdecision,\n\t\tmodelInputs: [\n\t\t\tmodelInput(decision.selectedModel),\n\t\t\t...decision.fallbackChain.map(modelInput),\n\t\t],\n\t};\n}\n\nexport function recordIntelligentRouterChatMetric(params: {\n\ttaskType: string;\n\tprovider: string;\n\tmodel: string;\n\tstartedAt: number;\n\tmessage: AssistantMessage;\n}): void {\n\tconst usage = params.message.usage;\n\tvoid Promise.resolve()\n\t\t.then(() => {\n\t\t\tconst costUsd = usage.cost?.total;\n\t\t\tgetIntelligentRouterService().recordPerformanceMetric({\n\t\t\t\ttaskType: params.taskType,\n\t\t\t\tprovider: params.provider,\n\t\t\t\tmodel: params.model,\n\t\t\t\tlatencyMs: Date.now() - params.startedAt,\n\t\t\t\tsuccess: params.message.stopReason !== \"error\",\n\t\t\t\toccurredAt: new Date(params.message.timestamp),\n\t\t\t\t...(typeof costUsd === \"number\" ? { costUsd } : {}),\n\t\t\t});\n\t\t})\n\t\t.catch((error) => {\n\t\t\tlogger.warn(\"Intelligent router metric recording failed\", {\n\t\t\t\terror: error instanceof Error ? error.message : String(error),\n\t\t\t\ttaskType: params.taskType,\n\t\t\t\tprovider: params.provider,\n\t\t\t\tmodel: params.model,\n\t\t\t});\n\t\t});\n}\n"]}

package/dist/services/intelligent-router/service.d.ts

@@ -0,0 +1,22 @@
+import type { ModelPerformanceAggregate, ModelPerformanceMetricInput, RoutingDecision, RoutingModelCandidate, RoutingOverride, RoutingOverrideInput, RoutingRequestInput } from "./types.js";
+export declare class IntelligentRouterService {
+    private readonly defaultModels;
+    private readonly now;
+    private readonly metrics;
+    private readonly overrides;
+    private readonly decisions;
+    constructor(defaultModels?: () => RoutingModelCandidate[], now?: () => Date);
+    recordPerformanceMetric(input: ModelPerformanceMetricInput): ModelPerformanceAggregate;
+    routeRequest(input: RoutingRequestInput): RoutingDecision;
+    setOverride(input: RoutingOverrideInput): RoutingOverride;
+    deleteOverride(taskType: string): boolean;
+    listOverrides(): RoutingOverride[];
+    listMetrics(taskType?: string): ModelPerformanceAggregate[];
+    listDecisions(limit?: number): RoutingDecision[];
+    clearForTest(): void;
+    private getAggregate;
+    private pruneExpiredOverrides;
+}
+export declare function getIntelligentRouterService(): IntelligentRouterService;
+export declare function setIntelligentRouterServiceForTest(service: IntelligentRouterService | null): void;
+//# sourceMappingURL=service.d.ts.map

package/dist/services/intelligent-router/service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"service.d.ts","sourceRoot":"","sources":["../../../src/services/intelligent-router/service.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EACX,yBAAyB,EACzB,2BAA2B,EAE3B,eAAe,EACf,qBAAqB,EACrB,eAAe,EACf,oBAAoB,EACpB,mBAAmB,EAGnB,MAAM,YAAY,CAAC;AA6MpB,qBAAa,wBAAwB;IAMnC,OAAO,CAAC,QAAQ,CAAC,aAAa;IAC9B,OAAO,CAAC,QAAQ,CAAC,GAAG;IANrB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAkC;IAC1D,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAsC;IAChE,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAyB;gBAGjC,aAAa,GAAE,MAAM,qBAAqB,EAAa,EACvD,GAAG,GAAE,MAAM,IAAuB;IAGpD,uBAAuB,CACtB,KAAK,EAAE,2BAA2B,GAChC,yBAAyB;IAoC5B,YAAY,CAAC,KAAK,EAAE,mBAAmB,GAAG,eAAe;IA2GzD,WAAW,CAAC,KAAK,EAAE,oBAAoB,GAAG,eAAe;IAkBzD,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO;IAIzC,aAAa,IAAI,eAAe,EAAE;IAOlC,WAAW,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,yBAAyB,EAAE;IAe3D,aAAa,CAAC,KAAK,SAAK,GAAG,eAAe,EAAE;IAK5C,YAAY,IAAI,IAAI;IAMpB,OAAO,CAAC,YAAY;IASpB,OAAO,CAAC,qBAAqB;CAQ7B;AAID,wBAAgB,2BAA2B,IAAI,wBAAwB,CAGtE;AAED,wBAAgB,kCAAkC,CACjD,OAAO,EAAE,wBAAwB,GAAG,IAAI,GACtC,IAAI,CAEN"}