@shapeshift-labs/frontier-swarm 0.5.9 → 0.5.11

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.9",
+  "version": "0.5.11",
   "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"
@@ -35,13 +36,14 @@
   "scripts": {
     "build": "node build.mjs",
     "test": "npm run build && npm run typecheck && node test/smoke.mjs && node test/fuzz.mjs --cases 700",
-    "prepack": "npm run readme:packages:check && npm run test",
+    "prepack": "npm run lint && npm run readme:packages:check && npm run test",
     "typecheck": "node build.mjs --typecheck",
     "fuzz": "npm run build && node test/fuzz.mjs",
     "bench": "npm run build && node --expose-gc benchmarks/package-bench.mjs --out benchmarks/results/frontier-swarm-package-bench-latest.json",
     "pack:dry": "npm pack --dry-run",
     "readme:packages": "node benchmarks/package-readme-sections.mjs",
-    "readme:packages:check": "node benchmarks/package-readme-sections.mjs --check"
+    "readme:packages:check": "node benchmarks/package-readme-sections.mjs --check",
+    "lint": "node scripts/strict-source-policy.mjs"
   },
   "keywords": [
     "frontier",