@shapeshift-labs/frontier-swarm 0.5.10 → 0.5.12

package/dist/trace-types.d.ts

@@ -0,0 +1,168 @@
+import type { JsonObject } from '@shapeshift-labs/frontier';
+import type { FRONTIER_SWARM_TRACE_INDEX_KIND, FRONTIER_SWARM_TRACE_INDEX_VERSION, FRONTIER_SWARM_TRACE_SHARD_KIND, FRONTIER_SWARM_TRACE_SHARD_VERSION } from './constants.js';
+import type { FrontierSwarmNamedRef, FrontierSwarmNamedRefInput } from './context-types.js';
+import type { FrontierSwarmCommand, FrontierSwarmCommandInput } from './manifest-types.js';
+import type { FrontierSwarmMergeBundle } from './merge-types.js';
+import type { FrontierSwarmDivergenceReport, FrontierSwarmDivergenceReportInput } from './observability-types.js';
+import type { FrontierSwarmConfidence, FrontierSwarmRiskLevel, FrontierSwarmTraceShardStatus } from './status-types.js';
+export interface FrontierSwarmTraceRowWindowInput {
+    id?: string;
+    title?: string;
+    start?: number;
+    end?: number;
+    rowCount?: number;
+    firstDivergenceAt?: number;
+    deltaFields?: readonly string[];
+    evidenceRefs?: readonly (string | FrontierSwarmNamedRefInput)[];
+    metadata?: unknown;
+}
+export interface FrontierSwarmTraceRowWindow {
+    id: string;
+    title: string;
+    start?: number;
+    end?: number;
+    rowCount?: number;
+    firstDivergenceAt?: number;
+    deltaFields: string[];
+    evidenceRefs: FrontierSwarmNamedRef[];
+    metadata?: JsonObject;
+}
+export interface FrontierSwarmTraceHypothesisInput {
+    id?: string;
+    title?: string;
+    sourcePath?: string;
+    line?: number;
+    symbol?: string;
+    region?: string;
+    confidence?: FrontierSwarmConfidence;
+    reason?: string;
+    evidenceRefs?: readonly (string | FrontierSwarmNamedRefInput)[];
+    metadata?: unknown;
+}
+export interface FrontierSwarmTraceHypothesis {
+    id: string;
+    title: string;
+    sourcePath?: string;
+    line?: number;
+    symbol?: string;
+    region?: string;
+    confidence: FrontierSwarmConfidence;
+    reason?: string;
+    evidenceRefs: FrontierSwarmNamedRef[];
+    metadata?: JsonObject;
+}
+export interface FrontierSwarmExecutableOwnershipRegionInput {
+    id: string;
+    kind?: string;
+    sourcePath?: string;
+    symbol?: string;
+    selectors?: readonly string[];
+    affectedTests?: readonly (string | FrontierSwarmCommandInput)[];
+    conflictingAssumptions?: readonly string[];
+    traceRefs?: readonly (string | FrontierSwarmNamedRefInput)[];
+    riskLevel?: FrontierSwarmRiskLevel;
+    metadata?: unknown;
+}
+export interface FrontierSwarmExecutableOwnershipRegion {
+    id: string;
+    kind: string;
+    sourcePath?: string;
+    symbol?: string;
+    selectors: string[];
+    affectedTests: FrontierSwarmCommand[];
+    conflictingAssumptions: string[];
+    traceRefs: FrontierSwarmNamedRef[];
+    riskLevel: FrontierSwarmRiskLevel;
+    metadata?: JsonObject;
+}
+export interface FrontierSwarmTraceShardInput {
+    id?: string;
+    jobId?: string;
+    lane?: string;
+    subject?: string;
+    status?: FrontierSwarmTraceShardStatus;
+    traceRefs?: readonly (string | FrontierSwarmNamedRefInput)[];
+    divergence?: FrontierSwarmDivergenceReport | FrontierSwarmDivergenceReportInput;
+    rowWindows?: readonly FrontierSwarmTraceRowWindowInput[];
+    hypotheses?: readonly FrontierSwarmTraceHypothesisInput[];
+    executableOwnershipRegions?: readonly FrontierSwarmExecutableOwnershipRegionInput[];
+    focusedTests?: readonly (string | FrontierSwarmCommandInput)[];
+    referenceEvidence?: readonly (string | FrontierSwarmNamedRefInput)[];
+    generatedAt?: number;
+    metadata?: unknown;
+}
+export interface FrontierSwarmTraceShard {
+    kind: typeof FRONTIER_SWARM_TRACE_SHARD_KIND;
+    version: typeof FRONTIER_SWARM_TRACE_SHARD_VERSION;
+    id: string;
+    jobId?: string;
+    lane?: string;
+    subject?: string;
+    status: FrontierSwarmTraceShardStatus;
+    traceRefs: FrontierSwarmNamedRef[];
+    divergence?: FrontierSwarmDivergenceReport;
+    rowWindows: FrontierSwarmTraceRowWindow[];
+    hypotheses: FrontierSwarmTraceHypothesis[];
+    executableOwnershipRegions: FrontierSwarmExecutableOwnershipRegion[];
+    focusedTests: FrontierSwarmCommand[];
+    referenceEvidence: FrontierSwarmNamedRef[];
+    generatedAt: number;
+    summary: {
+        rowWindowCount: number;
+        hypothesisCount: number;
+        executableOwnershipRegionCount: number;
+        focusedTestCount: number;
+        referenceEvidenceCount: number;
+        hasDivergence: boolean;
+    };
+    metadata?: JsonObject;
+}
+export interface FrontierSwarmTraceIndexInput {
+    id?: string;
+    shards?: readonly (FrontierSwarmTraceShard | FrontierSwarmTraceShardInput)[];
+    bundles?: readonly FrontierSwarmMergeBundle[];
+    generatedAt?: number;
+    metadata?: unknown;
+}
+export interface FrontierSwarmTraceIndex {
+    kind: typeof FRONTIER_SWARM_TRACE_INDEX_KIND;
+    version: typeof FRONTIER_SWARM_TRACE_INDEX_VERSION;
+    id: string;
+    generatedAt: number;
+    shards: FrontierSwarmTraceShard[];
+    byJobId: Record<string, FrontierSwarmTraceShard[]>;
+    bySubject: Record<string, FrontierSwarmTraceShard[]>;
+    byRegion: Record<string, FrontierSwarmTraceShard[]>;
+    bySourcePath: Record<string, FrontierSwarmTraceShard[]>;
+    summary: {
+        shardCount: number;
+        rowWindowCount: number;
+        hypothesisCount: number;
+        executableOwnershipRegionCount: number;
+        focusedTestCount: number;
+        referenceEvidenceCount: number;
+        divergenceCount: number;
+    };
+    metadata?: JsonObject;
+}
+export interface FrontierSwarmTraceIndexQuery {
+    jobId?: string;
+    lane?: string;
+    subject?: string;
+    region?: string;
+    sourcePath?: string;
+    status?: FrontierSwarmTraceShardStatus;
+    minConfidence?: number;
+    hasDivergence?: boolean;
+    textIncludes?: string;
+}
+export interface FrontierSwarmTraceIndexQueryResult {
+    shards: FrontierSwarmTraceShard[];
+    summary: {
+        shardCount: number;
+        rowWindowCount: number;
+        hypothesisCount: number;
+        executableOwnershipRegionCount: number;
+    };
+}
+//# sourceMappingURL=trace-types.d.ts.map

package/dist/trace-types.d.ts.map

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

package/dist/trace-types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=trace-types.js.map

package/dist/trace-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"trace-types.js","sourceRoot":"","sources":["../src/trace-types.ts"],"names":[],"mappings":""}

package/dist/types.d.ts

@@ -0,0 +1,19 @@
+export type * from './status-types.js';
+export type * from './manifest-types.js';
+export type * from './task-types.js';
+export type * from './queue-types.js';
+export type * from './run-types.js';
+export type * from './semantic-types.js';
+export type * from './result-types.js';
+export type * from './merge-types.js';
+export type * from './merge-review-types.js';
+export type * from './context-types.js';
+export type * from './observability-types.js';
+export type * from './trace-types.js';
+export type * from './debug-types.js';
+export type * from './evidence-types.js';
+export type * from './reference-types.js';
+export type * from './governance-types.js';
+export type * from './coordinator-types.js';
+export type * from './adaptive-types.js';
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,mBAAmB,mBAAmB,CAAC;AACvC,mBAAmB,qBAAqB,CAAC;AACzC,mBAAmB,iBAAiB,CAAC;AACrC,mBAAmB,kBAAkB,CAAC;AACtC,mBAAmB,gBAAgB,CAAC;AACpC,mBAAmB,qBAAqB,CAAC;AACzC,mBAAmB,mBAAmB,CAAC;AACvC,mBAAmB,kBAAkB,CAAC;AACtC,mBAAmB,yBAAyB,CAAC;AAC7C,mBAAmB,oBAAoB,CAAC;AACxC,mBAAmB,0BAA0B,CAAC;AAC9C,mBAAmB,kBAAkB,CAAC;AACtC,mBAAmB,kBAAkB,CAAC;AACtC,mBAAmB,qBAAqB,CAAC;AACzC,mBAAmB,sBAAsB,CAAC;AAC1C,mBAAmB,uBAAuB,CAAC;AAC3C,mBAAmB,wBAAwB,CAAC;AAC5C,mBAAmB,qBAAqB,CAAC"}

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/dist/usage-governor.d.ts

@@ -0,0 +1,41 @@
+import type { JsonObject } from '@shapeshift-labs/frontier';
+export declare const FRONTIER_SWARM_USAGE_GOVERNOR_KIND = "frontier.swarm.usage-governor";
+export declare const FRONTIER_SWARM_USAGE_GOVERNOR_VERSION = 1;
+export interface FrontierSwarmUsageGovernorInput {
+    id?: string;
+    maxWorkers?: number;
+    maxTokensByLane?: Record<string, number>;
+    maxCostUsd?: number;
+    retryBudget?: number;
+    stopConditions?: readonly string[];
+    preferStaticWhenLowBudget?: boolean;
+    generatedAt?: number;
+    metadata?: unknown;
+}
+export interface FrontierSwarmUsageGovernor {
+    kind: typeof FRONTIER_SWARM_USAGE_GOVERNOR_KIND;
+    version: typeof FRONTIER_SWARM_USAGE_GOVERNOR_VERSION;
+    id: string;
+    generatedAt: number;
+    maxWorkers?: number;
+    maxTokensByLane: Record<string, number>;
+    maxCostUsd?: number;
+    retryBudget: number;
+    stopConditions: string[];
+    preferStaticWhenLowBudget: boolean;
+    metadata?: JsonObject;
+}
+export interface FrontierSwarmUsageGovernorDecision {
+    ok: boolean;
+    reasons: string[];
+    recommendedMaxWorkers?: number;
+    preferStatic: boolean;
+}
+export declare function createSwarmUsageGovernor(input?: FrontierSwarmUsageGovernorInput): FrontierSwarmUsageGovernor;
+export declare function checkSwarmUsageGovernor(governorInput: FrontierSwarmUsageGovernor | FrontierSwarmUsageGovernorInput, usage?: {
+    activeWorkers?: number;
+    costUsd?: number;
+    tokensByLane?: Record<string, number>;
+    retriesUsed?: number;
+}): FrontierSwarmUsageGovernorDecision;
+//# sourceMappingURL=usage-governor.d.ts.map

package/dist/usage-governor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"usage-governor.d.ts","sourceRoot":"","sources":["../src/usage-governor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AAG5D,eAAO,MAAM,kCAAkC,kCAAkC,CAAC;AAClF,eAAO,MAAM,qCAAqC,IAAI,CAAC;AAEvD,MAAM,WAAW,+BAA+B;IAC9C,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACzC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,cAAc,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACnC,yBAAyB,CAAC,EAAE,OAAO,CAAC;IACpC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,0BAA0B;IACzC,IAAI,EAAE,OAAO,kCAAkC,CAAC;IAChD,OAAO,EAAE,OAAO,qCAAqC,CAAC;IACtD,EAAE,EAAE,MAAM,CAAC;IACX,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACxC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,yBAAyB,EAAE,OAAO,CAAC;IACnC,QAAQ,CAAC,EAAE,UAAU,CAAC;CACvB;AAED,MAAM,WAAW,kCAAkC;IACjD,EAAE,EAAE,OAAO,CAAC;IACZ,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,YAAY,EAAE,OAAO,CAAC;CACvB;AAED,wBAAgB,wBAAwB,CAAC,KAAK,GAAE,+BAAoC,GAAG,0BAA0B,CAehH;AAED,wBAAgB,uBAAuB,CACrC,aAAa,EAAE,0BAA0B,GAAG,+BAA+B,EAC3E,KAAK,GAAE;IAAE,aAAa,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,CAAA;CAAO,GACpH,kCAAkC,CAepC"}

package/dist/usage-governor.js

@@ -0,0 +1,43 @@
+import { positiveNumber, stableHash, toJsonObject, uniqueStrings } from './internal.js';
+export const FRONTIER_SWARM_USAGE_GOVERNOR_KIND = 'frontier.swarm.usage-governor';
+export const FRONTIER_SWARM_USAGE_GOVERNOR_VERSION = 1;
+export function createSwarmUsageGovernor(input = {}) {
+    const generatedAt = input.generatedAt ?? Date.now();
+    return {
+        kind: FRONTIER_SWARM_USAGE_GOVERNOR_KIND,
+        version: FRONTIER_SWARM_USAGE_GOVERNOR_VERSION,
+        id: input.id ?? 'swarm-usage-governor:' + stableHash([input.maxWorkers, input.maxTokensByLane, input.maxCostUsd, input.retryBudget, generatedAt]),
+        generatedAt,
+        ...(positiveNumber(input.maxWorkers) ? { maxWorkers: Math.floor(input.maxWorkers) } : {}),
+        maxTokensByLane: { ...(input.maxTokensByLane ?? {}) },
+        ...(positiveNumber(input.maxCostUsd) ? { maxCostUsd: input.maxCostUsd } : {}),
+        retryBudget: Math.max(0, Math.floor(input.retryBudget ?? 0)),
+        stopConditions: uniqueStrings(input.stopConditions ?? []),
+        preferStaticWhenLowBudget: input.preferStaticWhenLowBudget ?? true,
+        ...(toJsonObject(input.metadata) ? { metadata: toJsonObject(input.metadata) } : {})
+    };
+}
+export function checkSwarmUsageGovernor(governorInput, usage = {}) {
+    const governor = isSwarmUsageGovernor(governorInput) ? governorInput : createSwarmUsageGovernor(governorInput);
+    const reasons = [];
+    if (governor.maxWorkers !== undefined && (usage.activeWorkers ?? 0) > governor.maxWorkers)
+        reasons.push('max-workers');
+    if (governor.maxCostUsd !== undefined && (usage.costUsd ?? 0) > governor.maxCostUsd)
+        reasons.push('max-cost-usd');
+    if ((usage.retriesUsed ?? 0) > governor.retryBudget)
+        reasons.push('retry-budget');
+    for (const [lane, maxTokens] of Object.entries(governor.maxTokensByLane)) {
+        if ((usage.tokensByLane?.[lane] ?? 0) > maxTokens)
+            reasons.push(`max-tokens:${lane}`);
+    }
+    return {
+        ok: reasons.length === 0,
+        reasons,
+        ...(governor.maxWorkers !== undefined ? { recommendedMaxWorkers: Math.max(1, governor.maxWorkers - (reasons.length ? 1 : 0)) } : {}),
+        preferStatic: governor.preferStaticWhenLowBudget && reasons.some((reason) => reason.startsWith('max-tokens') || reason === 'max-cost-usd')
+    };
+}
+function isSwarmUsageGovernor(value) {
+    return !!value && typeof value === 'object' && value.kind === FRONTIER_SWARM_USAGE_GOVERNOR_KIND;
+}
+//# sourceMappingURL=usage-governor.js.map

package/dist/usage-governor.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@shapeshift-labs/frontier-swarm",
-  "version": "0.5.10",
+  "version": "0.5.12",
   "description": "Hierarchical swarm plans, lanes, compute profiles, ownership policy, events, and proofs for Frontier agent work.",
   "type": "module",
   "license": "MIT",
@@ -27,7 +27,8 @@
     "dist",
     "README.md",
     "LICENSE",
-    "benchmarks/package-bench.mjs"
+    "benchmarks/package-bench.mjs",
+    "benchmarks/package-bench-*.mjs"
   ],
   "engines": {
     "node": ">=18"