@shapeshift-labs/frontier-swarm 0.5.4 → 0.5.6

package/README.md

@@ -36,7 +36,7 @@ The published Frontier package family is generated from one shared package catal
 - [`@shapeshift-labs/frontier-workflow`](https://www.npmjs.com/package/@shapeshift-labs/frontier-workflow): Serializable durable workflow/process manifests for Frontier apps, including steps, waits, approvals, timers, retries, expected patches, compensation, records, timelines, and registry graph output.
 - [`@shapeshift-labs/frontier-worker`](https://www.npmjs.com/package/@shapeshift-labs/frontier-worker): Serializable worker and edge task descriptors for Frontier apps, including queues, idempotency keys, retry and timeout policy, declared reads/writes/effects, snapshots, patch outputs, produced assets, execution records, logs, trace links, proof hashes, dedupe indexes, and registry graph output.
 - [`@shapeshift-labs/frontier-queue`](https://www.npmjs.com/package/@shapeshift-labs/frontier-queue): Serializable durable queue state, leases, retries, dedupe keys, patch-carrying jobs, dead-letter records, replay evidence, and queue inspection for Frontier apps.
-- [`@shapeshift-labs/frontier-swarm-codex`](https://www.npmjs.com/package/@shapeshift-labs/frontier-swarm-codex): Node Codex CLI adapter for Frontier swarm plans, including prompt rendering, worktree and snapshot workspaces, Codex argument compatibility, browser resource allocation, JSONL capture, verification commands, pid-backed stop, collect/apply workflows, merge indexes, queue overlays, merge bundles, and result artifacts.
+- [`@shapeshift-labs/frontier-swarm-codex`](https://www.npmjs.com/package/@shapeshift-labs/frontier-swarm-codex): Node Codex CLI adapter for Frontier swarm plans, including prompt rendering, worktree and snapshot workspaces, Codex argument compatibility, browser resource allocation, JSONL capture, verification commands, pid-backed stop, collect/apply workflows, merge indexes, queue overlays, merge bundles, normalized job evidence, coordinator query artifacts, and result artifacts.
 - [`@shapeshift-labs/frontier-lang-kernel`](https://www.npmjs.com/package/@shapeshift-labs/frontier-lang-kernel): Runtime-neutral semantic source graph, type/lattice/extern declarations, patch bundles, replay, hashing, evidence records, and merge-admission kernel for Frontier Lang.
 - [`@shapeshift-labs/frontier-lang-parser`](https://www.npmjs.com/package/@shapeshift-labs/frontier-lang-parser): Dependency-light Frontier Lang parser for modules, entities, state, actions, effects, types, externs, targets, and lattice declarations.
 - [`@shapeshift-labs/frontier-lang-checker`](https://www.npmjs.com/package/@shapeshift-labs/frontier-lang-checker): Checker and diagnostics for Frontier Lang semantic documents, including type symbols, effects, regions, lattice laws, CRDT metadata, and patch evidence.
@@ -45,7 +45,13 @@ The published Frontier package family is generated from one shared package catal
 - [`@shapeshift-labs/frontier-lang-rust`](https://www.npmjs.com/package/@shapeshift-labs/frontier-lang-rust): Rust projection adapter for Frontier Lang semantic documents, including structs, aliases, and action stubs.
 - [`@shapeshift-labs/frontier-lang-python`](https://www.npmjs.com/package/@shapeshift-labs/frontier-lang-python): Python projection adapter for Frontier Lang semantic documents, including dataclasses, typed patch records, and action stubs.
 - [`@shapeshift-labs/frontier-lang-c`](https://www.npmjs.com/package/@shapeshift-labs/frontier-lang-c): C header projection adapter for Frontier Lang semantic documents, including structs and action prototypes.
-- [`@shapeshift-labs/frontier-lang-compiler`](https://www.npmjs.com/package/@shapeshift-labs/frontier-lang-compiler): Compiler facade for Frontier Lang source documents, including parse, check, hash, diagnostics, and projection to TypeScript, JavaScript, Rust, Python, and C.
+- [`@shapeshift-labs/frontier-lang-compiler`](https://www.npmjs.com/package/@shapeshift-labs/frontier-lang-compiler): Compiler facade for Frontier Lang source documents, including parse, check, hash, diagnostics, projection to TypeScript, JavaScript, Rust, Python, and C, and native source-import adapters for semantic merge evidence.
+- [`@shapeshift-labs/frontier-lang-swift`](https://www.npmjs.com/package/@shapeshift-labs/frontier-lang-swift): Swift source-language importer package for Frontier Lang semantic documents, including package-level metadata, SwiftSyntax adapter helpers, native import results, and semantic sidecar generation for SwiftSyntax/SwiftParser-shaped syntax trees.
+- [`@shapeshift-labs/frontier-lang-kotlin`](https://www.npmjs.com/package/@shapeshift-labs/frontier-lang-kotlin): Kotlin PSI source-language importer package for Frontier Lang semantic documents, including package-level metadata, Kotlin PSI adapter helpers, native import results, and semantic sidecar generation for Kotlin PSI/KtFile-shaped syntax trees.
+- [`@shapeshift-labs/frontier-lang-java`](https://www.npmjs.com/package/@shapeshift-labs/frontier-lang-java): Java source-language importer package for Frontier Lang semantic documents, including package-level metadata, Java AST adapter helpers, native import results, and semantic sidecar generation for javac/JDT/JavaParser-shaped ASTs.
+- [`@shapeshift-labs/frontier-lang-go`](https://www.npmjs.com/package/@shapeshift-labs/frontier-lang-go): Go source-language importer package for Frontier Lang semantic documents, including package-level metadata, Go AST adapter helpers, native import results, and semantic sidecar generation for go/ast File or Package trees.
+- [`@shapeshift-labs/frontier-lang-csharp`](https://www.npmjs.com/package/@shapeshift-labs/frontier-lang-csharp): C# Roslyn source-language importer package for Frontier Lang semantic documents, including package-level metadata, Roslyn adapter helpers, native import results, and semantic sidecar generation for SyntaxTree/SyntaxNode-shaped ASTs.
+- [`@shapeshift-labs/frontier-lang-clang`](https://www.npmjs.com/package/@shapeshift-labs/frontier-lang-clang): Clang AST source-language importer package for Frontier Lang semantic documents, including package-level metadata, Clang AST JSON adapter helpers, native import results, and semantic sidecar generation for C/C++ translation units.
 - [`@shapeshift-labs/frontier-lang-cli`](https://www.npmjs.com/package/@shapeshift-labs/frontier-lang-cli): Command line interface for parsing, checking, hashing, and emitting Frontier Lang projects.
 - [`@shapeshift-labs/frontier-lang`](https://www.npmjs.com/package/@shapeshift-labs/frontier-lang): Umbrella package for Frontier Lang kernel, parser, checker, and projection adapters.
 - [`@shapeshift-labs/frontier-kv`](https://www.npmjs.com/package/@shapeshift-labs/frontier-kv): Serializable in-memory key/value state for Frontier apps, including TTL, versioned compare-and-set, batched patch mutations, scans, watchers, snapshots, JSONL event evidence, and replay verification.
@@ -133,6 +139,12 @@ Package source repositories:
 - [`siliconjungle/-shapeshift-labs-frontier-lang-python`](https://github.com/siliconjungle/-shapeshift-labs-frontier-lang-python)
 - [`siliconjungle/-shapeshift-labs-frontier-lang-c`](https://github.com/siliconjungle/-shapeshift-labs-frontier-lang-c)
 - [`siliconjungle/-shapeshift-labs-frontier-lang-compiler`](https://github.com/siliconjungle/-shapeshift-labs-frontier-lang-compiler)
+- [`siliconjungle/-shapeshift-labs-frontier-lang-swift`](https://github.com/siliconjungle/-shapeshift-labs-frontier-lang-swift)
+- [`siliconjungle/-shapeshift-labs-frontier-lang-kotlin`](https://github.com/siliconjungle/-shapeshift-labs-frontier-lang-kotlin)
+- [`siliconjungle/-shapeshift-labs-frontier-lang-java`](https://github.com/siliconjungle/-shapeshift-labs-frontier-lang-java)
+- [`siliconjungle/-shapeshift-labs-frontier-lang-go`](https://github.com/siliconjungle/-shapeshift-labs-frontier-lang-go)
+- [`siliconjungle/-shapeshift-labs-frontier-lang-csharp`](https://github.com/siliconjungle/-shapeshift-labs-frontier-lang-csharp)
+- [`siliconjungle/-shapeshift-labs-frontier-lang-clang`](https://github.com/siliconjungle/-shapeshift-labs-frontier-lang-clang)
 - [`siliconjungle/-shapeshift-labs-frontier-lang-cli`](https://github.com/siliconjungle/-shapeshift-labs-frontier-lang-cli)
 - [`siliconjungle/-shapeshift-labs-frontier-lang`](https://github.com/siliconjungle/-shapeshift-labs-frontier-lang)
 - [`siliconjungle/-shapeshift-labs-frontier-kv`](https://github.com/siliconjungle/-shapeshift-labs-frontier-kv)
@@ -280,6 +292,8 @@ The scale APIs are runtime-neutral and serializable:
 - `createSwarmReviewerLanePlan` turns risky/conflicting merge bundles into reviewer-lane tasks,
 - `createSwarmRunStoreShards` describes sharded event/result/checkpoint paths for large run stores,
 - `createSwarmMergeAdmission` limits ready merges by count, touched paths/regions, and risk budget,
+- `createSwarmCoordinatorDashboard` and `querySwarmCoordinatorDashboard` combine merge index entries, queue overlays, evidence indexes, admission decisions, duplicate groups, semantic sidecar summaries, source citations, and worker liveness into one coordinator-query surface with a compact merge score per job,
+- `createSwarmAdaptiveLoadPlan` treats declared concurrency/resource values as maximums and derives lower effective caps from deterministic observations such as browser/resource contention, stale patches, merge conflicts, empty semantic sidecars, log noise, discovery-only overproduction, failed evidence, and healthy throughput,
 - `createSwarmPatchStackPlan` clusters compatible bundles into candidate patch stacks by lane, path, region, disposition, and risk so reviewers can evaluate batches instead of individual worker directories,
 - `createSwarmContextPack` gives workers compact task context: relevant files, API maps, known failures, focused/oracle commands, expected evidence, exclusions, evidence schema, playbooks, and explicit dead ends to avoid,
 - `createSwarmOracleCorpus` indexes deterministic reference artifacts such as traces, snapshots, classifications, expected outputs, or fixtures without assuming a project domain,
@@ -330,6 +344,7 @@ That lets a parent swarm route implementation jobs to a deep model while evidenc
 - `createSwarmArtifactRoutingPlan`, `createSwarmSchedulerRecommendations`
 - `createSwarmFixtureCatalog`, `createSwarmProgressModel`, `createSwarmAutoReviewReport`, `createSwarmRebaseReport`
 - `createSwarmUsageGovernor`, `checkSwarmUsageGovernor`
+- `createSwarmAdaptiveLoadPlan`, `createSwarmScheduleInputFromAdaptiveLoadPlan`
 - `classifySwarmMergeReadiness`, `classifySwarmMergeDisposition`
 - `resolveSwarmChangedRegions`, `checkSwarmRegionOwnership`
 - `decomposeSwarmFeature`
@@ -347,7 +362,7 @@ Run the package-local benchmark:
 npm run bench
 ```
 
-The benchmark writes `benchmarks/results/frontier-swarm-package-bench-latest.json` when run from the monorepo. These are Frontier-only package measurements for plan creation, manifest validation, hierarchical compute resolution, ownership checks, scheduling/leases, queue snapshots, queue overlays, merge bundles, merge indexes, merge admission, hotspot reports, context packs, oracle corpora, replay/debug/evidence helper creation, lane playbooks, patch stack plans, event routing, run checkpoints, JSONL, and proof hashing.
+The benchmark writes `benchmarks/results/frontier-swarm-package-bench-latest.json` when run from the monorepo. These are Frontier-only package measurements for plan creation, manifest validation, hierarchical compute resolution, ownership checks, scheduling/leases, adaptive load planning, queue snapshots, queue overlays, merge bundles, merge indexes, merge admission, hotspot reports, context packs, oracle corpora, replay/debug/evidence helper creation, lane playbooks, patch stack plans, event routing, run checkpoints, JSONL, and proof hashing.
 
 ## Source Repository
 

package/benchmarks/package-bench.mjs

@@ -4,6 +4,7 @@ import { performance } from 'node:perf_hooks';
 import { fileURLToPath } from 'node:url';
 import {
   checkSwarmOwnership,
+  createSwarmAdaptiveLoadPlan,
   createSwarmContextPack,
   createSwarmHotspotReport,
   createSwarmLanePlaybook,
@@ -85,6 +86,18 @@ const rows = [
     leases = createSwarmLeases({ schedule, workerId: 'bench-worker', now: 1000 + cursor++, leaseMs: 60000, count: 16 });
     return schedule.ready.length + leases.length;
   }),
+  measure('adaptive-load-' + taskCount, 8, () => createSwarmAdaptiveLoadPlan({
+    plan,
+    schedule,
+    mode: 'balanced',
+    maxLimits: { maxReadyJobs: 128 },
+    currentLimits: { maxReadyJobs: 64 },
+    observations: [
+      { kind: 'semantic-empty', jobId: plan.jobs[cursor % plan.jobs.length].id, lane: plan.jobs[cursor % plan.jobs.length].lane },
+      { kind: 'log-noise', lane: 'runtime', value: 200000 }
+    ],
+    generatedAt: 1500 + cursor++
+  }).summary.decisionCount),
   measure('queue-snapshot-' + taskCount, 8, () => {
     const snapshot = createSwarmQueueSnapshot({ plan, run, leases, generatedAt: 2000 + cursor++ });
     return snapshot.summary.jobCount + snapshot.summary.leaseCount;

package/dist/index.d.ts

@@ -89,6 +89,10 @@ export declare const FRONTIER_SWARM_LANE_PLAYBOOK_KIND = "frontier.swarm.lane-pl
 export declare const FRONTIER_SWARM_LANE_PLAYBOOK_VERSION = 1;
 export declare const FRONTIER_SWARM_PATCH_STACK_PLAN_KIND = "frontier.swarm.patch-stack-plan";
 export declare const FRONTIER_SWARM_PATCH_STACK_PLAN_VERSION = 1;
+export declare const FRONTIER_SWARM_COORDINATOR_DASHBOARD_KIND = "frontier.swarm.coordinator-dashboard";
+export declare const FRONTIER_SWARM_COORDINATOR_DASHBOARD_VERSION = 1;
+export declare const FRONTIER_SWARM_ADAPTIVE_LOAD_PLAN_KIND = "frontier.swarm.adaptive-load-plan";
+export declare const FRONTIER_SWARM_ADAPTIVE_LOAD_PLAN_VERSION = 1;
 export declare const FRONTIER_SWARM_DEFAULT_CODEX_COMPUTE_ID = "codex.gpt-5.5.xhigh";
 export declare const FRONTIER_SWARM_DEFAULT_MODEL = "gpt-5.5";
 export declare const FRONTIER_SWARM_DEFAULT_REASONING_EFFORT = "xhigh";
@@ -111,6 +115,13 @@ export type FrontierSwarmBlackboardEntryKind = 'fact' | 'divergence' | 'rejected
 export type FrontierSwarmProgressStatus = 'not-started' | 'declared' | 'implemented' | 'structure-verified' | 'visual-verified' | 'functional-verified' | 'collaboration-verified' | 'accepted' | 'rejected' | 'blocked' | string;
 export type FrontierSwarmAutoReviewFindingKind = 'stub-risk' | 'missing-evidence' | 'ownership-violation' | 'overlarge-patch' | 'weak-evidence' | 'strict-source-policy' | string;
 export type FrontierSwarmRebaseStatus = 'clean-apply' | 'textual-conflict' | 'semantic-overlap' | 'stale-evidence' | 'needs-rerun' | string;
+export type FrontierSwarmCoordinatorLiveness = 'running' | 'finished' | 'missing' | 'unknown' | string;
+export type FrontierSwarmCoordinatorAdmissionStatus = 'admitted' | 'deferred' | 'not-admissible' | 'unknown' | string;
+export type FrontierSwarmAdaptiveMode = 'off' | 'observe' | 'conservative' | 'balanced' | 'aggressive' | string;
+export type FrontierSwarmAdaptiveObservationKind = 'resource-capacity' | 'lane-capacity' | 'concurrency-key-capacity' | 'compute-capacity' | 'ready-capacity' | 'evidence-failure' | 'merge-conflict' | 'stale-patch' | 'browser-contention' | 'semantic-empty' | 'semantic-weak' | 'log-noise' | 'discovery-only-output' | 'duplicate-output' | 'budget-pressure' | 'slow-job' | 'healthy-throughput' | string;
+export type FrontierSwarmAdaptiveObservationSeverity = 'info' | 'warning' | 'error' | 'critical' | string;
+export type FrontierSwarmAdaptiveDecisionAction = 'observe' | 'decrease' | 'increase' | 'hold' | string;
+export type FrontierSwarmAdaptiveDecisionTarget = 'max-ready-jobs' | 'lane' | 'concurrency-key' | 'compute' | 'resource' | string;
 export interface FrontierSwarmComputeInput {
     id: string;
     kind?: FrontierSwarmComputeKind;
@@ -2465,6 +2476,235 @@ export interface FrontierSwarmPatchStack {
     conflicts: FrontierSwarmMergeConflict[];
     gateHints: string[];
 }
+export interface FrontierSwarmCoordinatorProcessInput {
+    pid?: number;
+    role?: string;
+    jobId?: string;
+    runId?: string;
+    status?: FrontierSwarmCoordinatorLiveness;
+    startedAt?: number;
+    lastSeenAt?: number;
+    command?: readonly string[];
+    metadata?: unknown;
+}
+export interface FrontierSwarmCoordinatorProcess {
+    pid?: number;
+    role: string;
+    jobId?: string;
+    runId?: string;
+    status: FrontierSwarmCoordinatorLiveness;
+    startedAt?: number;
+    lastSeenAt?: number;
+    command: string[];
+    metadata?: JsonObject;
+}
+export interface FrontierSwarmCoordinatorSourceCitation {
+    path: string;
+    kind: string;
+    symbol?: string;
+    region?: string;
+    confidence?: number;
+    metadata?: JsonObject;
+}
+export interface FrontierSwarmCoordinatorDashboardInput {
+    id?: string;
+    plan?: FrontierSwarmPlan;
+    run?: FrontierSwarmRun;
+    bundles?: readonly FrontierSwarmMergeBundle[];
+    mergeIndex?: FrontierSwarmMergeIndex;
+    queueOverlay?: FrontierSwarmQueueOverlay;
+    evidenceIndex?: FrontierSwarmEvidenceIndex;
+    admission?: FrontierSwarmMergeAdmission;
+    processes?: readonly FrontierSwarmCoordinatorProcessInput[];
+    generatedAt?: number;
+    metadata?: unknown;
+}
+export interface FrontierSwarmCoordinatorDashboard {
+    kind: typeof FRONTIER_SWARM_COORDINATOR_DASHBOARD_KIND;
+    version: typeof FRONTIER_SWARM_COORDINATOR_DASHBOARD_VERSION;
+    id: string;
+    runId?: string;
+    planId?: string;
+    generatedAt: number;
+    jobs: FrontierSwarmCoordinatorJob[];
+    duplicateGroups: FrontierSwarmCoordinatorDuplicateGroup[];
+    processes: FrontierSwarmCoordinatorProcess[];
+    byLane: Record<string, string[]>;
+    byDisposition: Record<string, string[]>;
+    byLiveness: Record<string, string[]>;
+    mergeIndex?: FrontierSwarmMergeIndex;
+    queueOverlay?: FrontierSwarmQueueOverlay;
+    evidenceIndex?: FrontierSwarmEvidenceIndex;
+    admission?: FrontierSwarmMergeAdmission;
+    summary: {
+        jobCount: number;
+        readyToApplyCount: number;
+        needsHumanPortCount: number;
+        failedEvidenceCount: number;
+        staleAgainstHeadCount: number;
+        duplicateGroupCount: number;
+        semanticSidecarCount: number;
+        semanticRegionCount: number;
+        averageMergeScore: number;
+    };
+    metadata?: JsonObject;
+}
+export interface FrontierSwarmCoordinatorJob {
+    jobId: string;
+    taskId?: string;
+    lane?: string;
+    title?: string;
+    status: FrontierSwarmJobStatus;
+    liveness: FrontierSwarmCoordinatorLiveness;
+    mergeReadiness: FrontierSwarmMergeReadiness;
+    disposition: FrontierSwarmMergeDisposition;
+    riskLevel: FrontierSwarmRiskLevel;
+    mergeScore: number;
+    mergeScoreReasons: string[];
+    admissionStatus: FrontierSwarmCoordinatorAdmissionStatus;
+    admissionReasons: string[];
+    staleAgainstHead: boolean;
+    duplicateGroupId?: string;
+    duplicateOf?: string;
+    changedPaths: string[];
+    changedRegions: string[];
+    semanticRegions: string[];
+    ownershipViolations: string[];
+    patchPath?: string;
+    evidencePaths: string[];
+    primaryEvidencePath?: string;
+    sourceCitations: FrontierSwarmCoordinatorSourceCitation[];
+    tests: {
+        passed: number;
+        failed: number;
+        requiredFailed: number;
+    };
+    semanticImport?: FrontierSwarmSemanticImportSummary;
+    generatedAt: number;
+}
+export interface FrontierSwarmCoordinatorDuplicateGroup {
+    id: string;
+    key: string;
+    jobIds: string[];
+    reason: string;
+}
+export interface FrontierSwarmCoordinatorDashboardQuery {
+    jobId?: string;
+    lane?: string;
+    disposition?: FrontierSwarmMergeDisposition;
+    liveness?: FrontierSwarmCoordinatorLiveness;
+    admissionStatus?: FrontierSwarmCoordinatorAdmissionStatus;
+    pathIncludes?: string;
+    region?: string;
+    hasSemanticImport?: boolean;
+    hasSemanticRegions?: boolean;
+    staleAgainstHead?: boolean;
+    duplicateOnly?: boolean;
+    minMergeScore?: number;
+    maxMergeScore?: number;
+}
+export interface FrontierSwarmCoordinatorDashboardQueryResult {
+    jobs: FrontierSwarmCoordinatorJob[];
+    summary: {
+        jobCount: number;
+        averageMergeScore: number;
+    };
+}
+export interface FrontierSwarmAdaptiveScheduleLimitsInput {
+    maxReadyJobs?: number;
+    maxLaneConcurrency?: Record<string, number>;
+    maxConcurrencyKeyConcurrency?: Record<string, number>;
+    maxComputeConcurrency?: Record<string, number>;
+    resourceQuotas?: Record<string, number>;
+}
+export interface FrontierSwarmAdaptiveObservationInput {
+    id?: string;
+    kind: FrontierSwarmAdaptiveObservationKind;
+    severity?: FrontierSwarmAdaptiveObservationSeverity;
+    at?: number;
+    value?: number;
+    jobId?: string;
+    taskId?: string;
+    lane?: string;
+    compute?: string;
+    concurrencyKey?: string;
+    resource?: string;
+    path?: string;
+    region?: string;
+    reason?: string;
+    reasons?: readonly string[];
+    metadata?: unknown;
+}
+export interface FrontierSwarmAdaptiveObservation {
+    id: string;
+    kind: FrontierSwarmAdaptiveObservationKind;
+    severity: FrontierSwarmAdaptiveObservationSeverity;
+    at: number;
+    value: number;
+    jobId?: string;
+    taskId?: string;
+    lane?: string;
+    compute?: string;
+    concurrencyKey?: string;
+    resource?: string;
+    path?: string;
+    region?: string;
+    reasons: string[];
+    metadata?: JsonObject;
+}
+export interface FrontierSwarmAdaptiveLoadPlanInput {
+    id?: string;
+    plan?: FrontierSwarmPlan;
+    run?: FrontierSwarmRun;
+    schedule?: FrontierSwarmSchedule;
+    mergeIndex?: FrontierSwarmMergeIndex;
+    dashboard?: FrontierSwarmCoordinatorDashboard;
+    admission?: FrontierSwarmMergeAdmission;
+    mode?: FrontierSwarmAdaptiveMode;
+    maxLimits?: FrontierSwarmAdaptiveScheduleLimitsInput;
+    currentLimits?: FrontierSwarmAdaptiveScheduleLimitsInput;
+    minLimits?: FrontierSwarmAdaptiveScheduleLimitsInput;
+    observations?: readonly FrontierSwarmAdaptiveObservationInput[];
+    generatedAt?: number;
+    metadata?: unknown;
+}
+export interface FrontierSwarmAdaptiveLoadDecision {
+    id: string;
+    action: FrontierSwarmAdaptiveDecisionAction;
+    target: FrontierSwarmAdaptiveDecisionTarget;
+    key?: string;
+    previous?: number;
+    next?: number;
+    max?: number;
+    min?: number;
+    reason: string;
+    observationIds: string[];
+}
+export interface FrontierSwarmAdaptiveLoadPlan {
+    kind: typeof FRONTIER_SWARM_ADAPTIVE_LOAD_PLAN_KIND;
+    version: typeof FRONTIER_SWARM_ADAPTIVE_LOAD_PLAN_VERSION;
+    id: string;
+    planId?: string;
+    runId?: string;
+    mode: FrontierSwarmAdaptiveMode;
+    generatedAt: number;
+    maxLimits: FrontierSwarmScheduleLimits;
+    currentLimits: FrontierSwarmScheduleLimits;
+    minLimits: FrontierSwarmScheduleLimits;
+    effectiveLimits: FrontierSwarmScheduleLimits;
+    observations: FrontierSwarmAdaptiveObservation[];
+    decisions: FrontierSwarmAdaptiveLoadDecision[];
+    summary: {
+        observationCount: number;
+        bottleneckCount: number;
+        decisionCount: number;
+        reducedCount: number;
+        increasedCount: number;
+        effectiveMaxReadyJobs?: number;
+        maxReadyJobs?: number;
+    };
+    metadata?: JsonObject;
+}
 export interface FrontierSwarmProof {
     kind: typeof FRONTIER_SWARM_PROOF_KIND;
     version: typeof FRONTIER_SWARM_PROOF_VERSION;
@@ -2536,6 +2776,13 @@ export declare function checkSwarmUsageGovernor(governorInput: FrontierSwarmUsag
 }): FrontierSwarmUsageGovernorDecision;
 export declare function createSwarmLanePlaybook(input: FrontierSwarmLanePlaybookInput): FrontierSwarmLanePlaybook;
 export declare function createSwarmPatchStackPlan(input: FrontierSwarmPatchStackPlanInput): FrontierSwarmPatchStackPlan;
+export declare function createSwarmCoordinatorDashboard(input?: FrontierSwarmCoordinatorDashboardInput): FrontierSwarmCoordinatorDashboard;
+export declare function querySwarmCoordinatorDashboard(dashboard: FrontierSwarmCoordinatorDashboard, query?: FrontierSwarmCoordinatorDashboardQuery): FrontierSwarmCoordinatorDashboardQueryResult;
+export declare function createSwarmAdaptiveLoadPlan(input?: FrontierSwarmAdaptiveLoadPlanInput): FrontierSwarmAdaptiveLoadPlan;
+export declare function createSwarmScheduleInputFromAdaptiveLoadPlan(plan: FrontierSwarmPlan, adaptive: FrontierSwarmAdaptiveLoadPlan, input?: {
+    run?: FrontierSwarmRun;
+    now?: number;
+}): FrontierSwarmScheduleInput;
 export declare function resolveSwarmCompute(manifestInput: FrontierSwarmManifest | FrontierSwarmManifestInput, taskInput: FrontierSwarmTask | FrontierSwarmTaskInput): FrontierSwarmCompute;
 export declare function createSwarmProof(input: FrontierSwarmManifest | FrontierSwarmPlan | FrontierSwarmRun, options?: {
     generatedAt?: number;