@shapeshift-labs/frontier-swarm 0.5.28 → 0.5.30

package/README.md

@@ -429,6 +429,8 @@ const route = createSwarmModelRoute({
 
 `createSwarmModelRoutingFeedback` and `createSwarmModelRoutingPolicy` cover the serializable feedback/policy layer above the model router. Matching feedback is converted into model outcome history, cost/duration signals are folded into candidate scoring, prefer/avoid/override signals can select or suppress candidates, and each routed job gets compact `metadata.modelRoute` evidence with fallback, selected, recommended compute ids, policy match counts, cost-signal counts, and route reasons.
 
+`createSwarmRoutingController` turns runtime telemetry records into the next routing policy and, when a plan carries its manifest snapshot, a rerouted plan for pending jobs. It converts per-job model telemetry into routing feedback, emits prefer/avoid/observe signals from success, verification, human-action, cost, and duration signals, and preserves protected/running/completed jobs. `rerouteSwarmPlan` exposes the plan-only step for runners that already have a policy and just need to update unstarted work during a refill.
+
 `createSwarmOptimizationSummary` gives runners a generic evidence record for routing decisions, panel/fusion decisions, tournament observations, RSI-style routing feedback, model diversity, and whether any feedback was consumed. Telemetry can be omitted entirely when unavailable or emitted with real zero counts when the run observed nothing.
 
 The returned record includes scored candidates, estimated cost and latency, price/outcome telemetry fallbacks, panel confidence lift, residual risk, and a human-readable explanation for `single-cheap`, `single-deep`, `panel`, or `tournament` recommendations.

package/dist/index.d.ts

@@ -817,6 +817,7 @@ export interface FrontierSwarmPlan {
     id: string;
     runId: string;
     manifestId: string;
+    manifest?: FrontierSwarmManifest;
     createdAt: number;
     filters: FrontierSwarmPlanFilter;
     limits: FrontierSwarmScheduleLimits;
@@ -4678,8 +4679,153 @@ export interface FrontierSwarmModelRoutingPolicy {
     };
     metadata?: JsonObject;
 }
+export interface FrontierSwarmModelTelemetryRecordInput {
+    id?: string;
+    generatedAt?: number;
+    runId?: string;
+    planId?: string;
+    jobId?: string;
+    taskId?: string;
+    lane?: string;
+    layer?: string;
+    workKind?: string;
+    taskKind?: string;
+    computeId?: string;
+    compute?: string;
+    computeKind?: string;
+    model?: string;
+    modelTier?: string;
+    reasoningEffort?: string;
+    serviceTier?: string;
+    status?: string;
+    mergeReadiness?: FrontierSwarmMergeReadiness | string;
+    mergeDisposition?: FrontierSwarmMergeDisposition | string;
+    durationMs?: number;
+    estimatedCostUsd?: number;
+    estimatedInputCostUsd?: number;
+    estimatedOutputCostUsd?: number;
+    billableInputTokens?: number;
+    outputTokens?: number;
+    priceKnown?: boolean;
+    costEstimateInputOnly?: boolean;
+    costEstimateMissingOutputTokens?: boolean;
+    verificationTotal?: number;
+    verificationPassed?: number;
+    verificationFailed?: number;
+    verificationRequiredFailed?: number;
+    ownershipViolationCount?: number;
+    changedPathCount?: number;
+    evidencePathCount?: number;
+    humanActionCount?: number;
+    openHumanActionCount?: number;
+    semanticImportPresent?: boolean;
+    metadata?: unknown;
+    [key: string]: unknown;
+}
+export interface FrontierSwarmModelTelemetrySummaryInput {
+    recordCount?: number;
+    jobCount?: number;
+    statusCounts?: Record<string, number>;
+    computeCounts?: Record<string, number>;
+    modelCounts?: Record<string, number>;
+    taskKindCounts?: Record<string, number>;
+    workKindCounts?: Record<string, number>;
+    totalDurationMs?: number;
+    estimatedCostUsd?: number;
+    estimatedInputCostUsd?: number;
+    estimatedOutputCostUsd?: number;
+    billableInputTokens?: number;
+    outputTokens?: number;
+    priceKnownRecordCount?: number;
+    unknownPriceRecordCount?: number;
+    verificationTotal?: number;
+    verificationPassed?: number;
+    verificationFailed?: number;
+    verificationRequiredFailed?: number;
+    humanActionCount?: number;
+    openHumanActionCount?: number;
+    metadata?: unknown;
+    [key: string]: unknown;
+}
+export interface FrontierSwarmRoutingControllerDecision {
+    id: string;
+    action: 'prefer' | 'avoid' | 'observe' | 'reroute' | string;
+    computeId?: string;
+    model?: string;
+    lane?: string;
+    workKind?: string;
+    taskKind?: string;
+    jobId?: string;
+    taskId?: string;
+    score?: number;
+    confidence: FrontierSwarmConfidence;
+    reason: string;
+    metadata?: JsonObject;
+}
+export interface FrontierSwarmRoutingControllerInput {
+    id?: string;
+    plan?: FrontierSwarmPlan;
+    records?: readonly FrontierSwarmModelTelemetryRecordInput[];
+    telemetry?: {
+        records?: readonly FrontierSwarmModelTelemetryRecordInput[];
+        summary?: FrontierSwarmModelTelemetrySummaryInput;
+    };
+    summary?: FrontierSwarmModelTelemetrySummaryInput;
+    basePolicy?: FrontierSwarmModelRoutingPolicyInput | FrontierSwarmModelRoutingPolicy | unknown;
+    defaultMode?: FrontierSwarmModelRoutingMode;
+    routingMode?: FrontierSwarmModelRoutingMode;
+    protectedJobIds?: readonly string[];
+    runningJobIds?: readonly string[];
+    completedJobIds?: readonly string[];
+    minSamples?: number;
+    preferSuccessRate?: number;
+    avoidSuccessRate?: number;
+    highCostUsd?: number;
+    generatedAt?: number;
+    metadata?: unknown;
+}
+export interface FrontierSwarmRoutingControllerSummary {
+    telemetryRecordCount: number;
+    telemetryJobCount: number;
+    feedbackCount: number;
+    signalCount: number;
+    preferCount: number;
+    avoidCount: number;
+    observeCount: number;
+    decisionCount: number;
+    reroutedJobCount: number;
+    changedComputeCount: number;
+    protectedJobCount: number;
+    missingPlanManifest: boolean;
+    summaryRecordCount?: number;
+    summaryEstimatedCostUsd?: number;
+}
+export interface FrontierSwarmRoutingController {
+    kind: 'frontier.swarm.routing-controller';
+    version: 1;
+    id: string;
+    generatedAt: number;
+    routingMode: FrontierSwarmModelRoutingMode;
+    policy: FrontierSwarmModelRoutingPolicy;
+    decisions: FrontierSwarmRoutingControllerDecision[];
+    routedPlan?: FrontierSwarmPlan;
+    summary: FrontierSwarmRoutingControllerSummary;
+    metadata?: JsonObject;
+}
+export interface FrontierSwarmReroutePlanInput {
+    plan: FrontierSwarmPlan;
+    routingPolicy: FrontierSwarmModelRoutingPolicyInput | FrontierSwarmModelRoutingPolicy | unknown;
+    routingMode?: FrontierSwarmModelRoutingMode;
+    protectedJobIds?: readonly string[];
+    runningJobIds?: readonly string[];
+    completedJobIds?: readonly string[];
+    generatedAt?: number;
+    metadata?: unknown;
+}
 export declare function createSwarmModelRoutingFeedback(input?: FrontierSwarmModelRoutingFeedbackInput): FrontierSwarmModelRoutingFeedback;
 export declare function createSwarmModelRoutingPolicy(input?: FrontierSwarmModelRoutingPolicyInput): FrontierSwarmModelRoutingPolicy;
+export declare function createSwarmRoutingController(input?: FrontierSwarmRoutingControllerInput): FrontierSwarmRoutingController;
+export declare function rerouteSwarmPlan(input: FrontierSwarmReroutePlanInput): FrontierSwarmPlan;
 export declare function createSwarmModelRoutingFeedbackFromBoard(input?: {
     board?: unknown;
     generatedAt?: number;