@mcoda/mswarm 0.1.89 → 0.1.91

package/dist/vendor/codali/improvement/ModelRouterCandidateBuilder.d.ts

@@ -0,0 +1,186 @@
+import type { CodaliStorageExportKind, CodaliStorageObjectPrivacyFlags } from "../storage/CodaliStorageContracts.js";
+import type { DatasetEligibilityGateAcceptedExample } from "./DatasetEligibilityGate.js";
+import type { DatasetExportManifestReaderResult } from "./DatasetExportManifestReader.js";
+export declare const CODALI_MODEL_ROUTER_CANDIDATE_SCHEMA_VERSION: "codali.improvement.model_router_candidate.v1";
+export declare const CODALI_MODEL_ROUTER_PROPOSAL_ARTIFACT: "model-router";
+export declare const CODALI_MODEL_ROUTER_SOURCE_ARTIFACT_TYPES: readonly ["model_router", "model-router", "router", "tool_router", "tool-router"];
+export declare const CODALI_MODEL_ROUTER_SUPPORTED_EXPORT_KINDS: readonly ["model-router"];
+export type CodaliModelRouterProposalArtifact = typeof CODALI_MODEL_ROUTER_PROPOSAL_ARTIFACT;
+export type CodaliModelRouterCandidateKind = "model_router";
+export type CodaliModelRouterPlanAction = "propose_shadow_route" | "no_change";
+export interface CodaliModelRouterObjectRefSummary {
+    refId: string;
+    kind: string;
+    contentHash: string;
+    byteSize: number;
+    mimeType: string;
+    deletionGroupId: string;
+    privacyFlags: CodaliStorageObjectPrivacyFlags;
+    uri?: string;
+    mediaType?: string;
+    metadataKeys: string[];
+}
+export interface CodaliModelRouterSourceExample {
+    recordId: string;
+    sourceGatewayRecordId?: string;
+    artifactTypes: string[];
+    preferenceSignals: DatasetEligibilityGateAcceptedExample["preferenceSignals"];
+    priorityScore: number;
+    comparisonRecordCount: number;
+    shadowRecordCount: number;
+    objectRefs: {
+        inputRef?: CodaliModelRouterObjectRefSummary;
+        outputRef?: CodaliModelRouterObjectRefSummary;
+        evidenceRefs: CodaliModelRouterObjectRefSummary[];
+    };
+    metadataShape: {
+        keys: string[];
+        comparisonKeys: string[];
+    };
+}
+export interface CodaliModelRouterCandidateIdentity {
+    identityKey: string;
+    comparisonRole: "primary" | "shadow" | "mixed";
+    agentSlug?: string;
+    tier?: string;
+    model?: string;
+    adapter?: string;
+    source?: string;
+    healthStatus?: string;
+    capabilities: string[];
+}
+export interface CodaliModelRouterInferenceMetricSummary {
+    averageInputTokens?: number;
+    averageOutputTokens?: number;
+    averageTotalTokens?: number;
+    averageQueueWaitMs?: number;
+    averageQueueDepth?: number;
+    averageThroughputTokensPerSecond?: number;
+    averageRequestsPerMinute?: number;
+    localInferenceSampleCount: number;
+}
+export interface CodaliModelRouterMetricScorecard {
+    quality: number;
+    toolAccuracy: number;
+    schemaSuccess: number;
+    latency: number;
+    cost: number;
+    availability: number;
+    confidence: number;
+    fallbackReliability: number;
+    finalScore: number;
+    sampleCount: number;
+    shadowSampleCount: number;
+    selectedByPolicyCount: number;
+    averageLatencyMs?: number;
+    averageCostUsd?: number;
+    inference: CodaliModelRouterInferenceMetricSummary;
+    failureRate: number;
+    fallbackRate: number;
+}
+export interface CodaliModelRouterRouteCandidate {
+    routeId: string;
+    role: string;
+    resolverRole: string;
+    action: "propose_shadow_route" | "preserve_current" | "no_change";
+    status: "proposed" | "blocked" | "no_change";
+    current?: CodaliModelRouterCandidateIdentity;
+    proposed?: CodaliModelRouterCandidateIdentity;
+    scoreDelta?: number;
+    primaryScorecard?: CodaliModelRouterMetricScorecard;
+    proposedScorecard?: CodaliModelRouterMetricScorecard;
+    blockedReasons: string[];
+    evidence: {
+        sourceRecordIds: string[];
+        sourceGatewayRecordIds: string[];
+        comparisonRecordIds: string[];
+        primarySampleCount: number;
+        shadowSampleCount: number;
+        scorecardSampleCount: number;
+        shadowEvidenceRequired: true;
+        shadowEvidencePresent: boolean;
+    };
+    rollbackPlan: {
+        reversible: true;
+        restoreIdentity?: CodaliModelRouterCandidateIdentity;
+        removeCandidateIdentity?: CodaliModelRouterCandidateIdentity;
+        steps: string[];
+    };
+}
+export interface CodaliModelRouterPlan {
+    planId: string;
+    action: CodaliModelRouterPlanAction;
+    status: "proposed" | "blocked";
+    reasons: string[];
+    routeCount: number;
+    proposedRouteCount: number;
+    preservedRouteCount: number;
+    noChangeRouteCount: number;
+    reversible: true;
+    requiresShadowEvidence: true;
+    productionRouterChangeAllowed: false;
+}
+export interface CodaliModelRouterImprovementCandidateSummary {
+    candidateId: string;
+    candidateKind: CodaliModelRouterCandidateKind;
+    status: "proposed" | "blocked" | "no_change";
+    sourceExportIds: string[];
+    sourceRecordIds: string[];
+    artifactIds: string[];
+    exampleCount: number;
+    objectBytes: number;
+    routeCount: number;
+    proposedRouteCount: number;
+    blockedReasons: string[];
+}
+export interface CodaliModelRouterCandidateBundle {
+    schemaVersion: typeof CODALI_MODEL_ROUTER_CANDIDATE_SCHEMA_VERSION;
+    artifact: CodaliModelRouterProposalArtifact;
+    source: {
+        exportId: string;
+        manifestId: string;
+        manifestPath: string;
+        exportKind: CodaliStorageExportKind;
+        checksum: string;
+        recordCount: number;
+        primaryArtifactRef?: CodaliModelRouterObjectRefSummary;
+    };
+    generationPolicy: {
+        deterministic: true;
+        dryRunOnly: true;
+        modifiesRuntimePrompts: false;
+        modifiesRuntimeCode: false;
+        modifiesRuntimeRouter: false;
+        productionRouterChangeAllowed: false;
+        requiresShadowEvidence: true;
+        reversible: true;
+        uploadEnabled: false;
+        preservesFinalSynthesisRoute: true;
+        finalSynthesizerFineTuning: false;
+    };
+    expectedShape: {
+        schemaVersion: typeof CODALI_MODEL_ROUTER_CANDIDATE_SCHEMA_VERSION;
+        artifact: CodaliModelRouterProposalArtifact;
+        requiredFields: string[];
+        routeCandidateRequiredFields: string[];
+        scorecardFields: string[];
+    };
+    sourceExamples: CodaliModelRouterSourceExample[];
+    evidenceSummary: {
+        comparisonRecordCount: number;
+        primaryRecordCount: number;
+        shadowRecordCount: number;
+        roleCount: number;
+        roles: string[];
+        metricInputs: Array<"quality" | "tool_accuracy" | "schema_success" | "latency" | "cost" | "availability" | "confidence" | "fallback_rate">;
+    };
+    routerPlan: CodaliModelRouterPlan;
+    routeCandidates: CodaliModelRouterRouteCandidate[];
+    candidates: CodaliModelRouterImprovementCandidateSummary[];
+}
+export interface BuildCodaliModelRouterCandidateBundleInput {
+    inspection: DatasetExportManifestReaderResult;
+    artifact?: CodaliModelRouterProposalArtifact;
+}
+export declare const buildCodaliModelRouterCandidateBundle: (input: BuildCodaliModelRouterCandidateBundleInput) => CodaliModelRouterCandidateBundle;
+//# sourceMappingURL=ModelRouterCandidateBuilder.d.ts.map

package/dist/vendor/codali/improvement/ModelRouterCandidateBuilder.d.ts.map

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