@hasna/loops 0.4.27 → 0.4.29

package/dist/lib/mode.js

@@ -2,7 +2,7 @@
 // package.json
 var package_default = {
   name: "@hasna/loops",
-  version: "0.4.27",
+  version: "0.4.29",
   description: "Persistent local loop and workflow runner for deterministic commands and headless AI coding agents",
   type: "module",
   main: "dist/index.js",
@@ -81,11 +81,14 @@ var package_default = {
     "build:bin": "bun build src/cli/index.ts --compile --outfile dist/loops",
     typecheck: "tsc --noEmit",
     test: "bun test",
+    "check:branding": "bun test scripts/check-branding.test.mjs && bun run scripts/check-branding.mjs",
     "test:boundary": "bun run scripts/no-private-cloud-boundary.mjs",
+    "check:contracts": "bun run scripts/check-storage-kit.mjs && bun run scripts/check-contract-conformance.mjs",
+    "check:supply-chain": "bun audit && bun audit --production && bun run check:contracts && bun run check:branding && bun pm pack --dry-run --ignore-scripts && bun run test:boundary && bun run scripts/check-packed-boundary.mjs",
     prepare: "test -d dist || bun run build",
     "dev:cli": "bun run src/cli/index.ts",
     "dev:daemon": "bun run src/daemon/index.ts",
-    prepublishOnly: "bun run build && bun run typecheck && bun test && bun run test:boundary"
+    prepublishOnly: "bun run build && bun run typecheck && bun test && bun run test:boundary && bun run check:supply-chain"
   },
   keywords: [
     "loops",
@@ -112,6 +115,8 @@ var package_default = {
     bun: ">=1.0.0"
   },
   dependencies: {
+    "@aws-sdk/client-secrets-manager": "^3.1083.0",
+    "@hasna/contracts": "0.5.2",
     "@hasna/events": "^0.1.9",
     "@modelcontextprotocol/sdk": "^1.29.0",
     "@openrouter/ai-sdk-provider": "2.9.1",
@@ -121,8 +126,7 @@ var package_default = {
     zod: "4.4.3"
   },
   optionalDependencies: {
-    "@hasna/machines": "0.0.49",
-    "@hasna/contracts": "^0.4.2"
+    "@hasna/machines": "0.0.49"
   },
   devDependencies: {
     "@types/bun": "latest",
@@ -144,13 +148,10 @@ function packageVersion() {
 
 // src/lib/mode.ts
 var LOOP_DEPLOYMENT_MODES = ["local", "self_hosted", "cloud"];
-var MODE_ENV_KEYS = ["LOOPS_MODE", "HASNA_LOOPS_MODE"];
-var API_URL_ENV_KEYS = ["LOOPS_API_URL", "HASNA_LOOPS_API_URL"];
-var CLOUD_API_URL_ENV_KEYS = ["LOOPS_CLOUD_API_URL", "HASNA_LOOPS_CLOUD_API_URL"];
-var DATABASE_URL_ENV_KEYS = ["LOOPS_DATABASE_URL", "HASNA_LOOPS_DATABASE_URL"];
-var API_TOKEN_ENV_KEYS = ["LOOPS_API_TOKEN", "HASNA_LOOPS_API_TOKEN"];
-var CLOUD_TOKEN_ENV_KEYS = ["LOOPS_CLOUD_TOKEN", "HASNA_LOOPS_CLOUD_TOKEN"];
-var TOKEN_ENV_KEYS = [...API_TOKEN_ENV_KEYS, ...CLOUD_TOKEN_ENV_KEYS];
+var MODE_ENV_KEYS = ["HASNA_LOOPS_STORAGE_MODE"];
+var API_URL_ENV_KEYS = ["HASNA_LOOPS_API_URL"];
+var DATABASE_URL_ENV_KEYS = ["HASNA_LOOPS_DATABASE_URL"];
+var API_KEY_ENV_KEYS = ["HASNA_LOOPS_API_KEY"];
 function envValue(env, keys) {
   for (const key of keys) {
     const value = env[key]?.trim();
@@ -160,14 +161,14 @@ function envValue(env, keys) {
   return;
 }
 function normalizeLoopDeploymentMode(value) {
-  const normalized = value.trim().toLowerCase().replace(/-/g, "_");
+  const normalized = value.trim();
   if (normalized === "local")
     return "local";
-  if (normalized === "self_hosted" || normalized === "selfhosted")
+  if (normalized === "self_hosted")
     return "self_hosted";
-  if (normalized === "cloud" || normalized === "saas")
+  if (normalized === "cloud")
     return "cloud";
-  throw new Error(`unsupported OpenLoops deployment mode "${value}"; expected local, self_hosted, or cloud`);
+  throw new Error(`unsupported Loops deployment mode "${value}"; expected local, self_hosted, or cloud`);
 }
 function resolveLoopDeploymentMode(env = process.env) {
   const explicitMode = envValue(env, MODE_ENV_KEYS);
@@ -177,9 +178,6 @@ function resolveLoopDeploymentMode(env = process.env) {
       source: explicitMode.key
     };
   }
-  const cloudApiUrl = envValue(env, CLOUD_API_URL_ENV_KEYS);
-  if (cloudApiUrl)
-    return { deploymentMode: "cloud", source: cloudApiUrl.key };
   const apiUrl = envValue(env, API_URL_ENV_KEYS);
   if (apiUrl)
     return { deploymentMode: "self_hosted", source: apiUrl.key };
@@ -191,11 +189,8 @@ function resolveLoopDeploymentMode(env = process.env) {
 function loopControlPlaneConfig(env = process.env) {
   return {
     apiUrl: envValue(env, API_URL_ENV_KEYS)?.value,
-    cloudApiUrl: envValue(env, CLOUD_API_URL_ENV_KEYS)?.value,
     databaseUrlPresent: Boolean(envValue(env, DATABASE_URL_ENV_KEYS)),
-    apiAuthTokenPresent: Boolean(envValue(env, API_TOKEN_ENV_KEYS)),
-    cloudAuthTokenPresent: Boolean(envValue(env, CLOUD_TOKEN_ENV_KEYS)),
-    authTokenPresent: Boolean(envValue(env, TOKEN_ENV_KEYS))
+    apiKeyPresent: Boolean(envValue(env, API_KEY_ENV_KEYS))
   };
 }
 function sourceOfTruthForMode(mode) {
@@ -217,7 +212,7 @@ function remoteSchedulerBackendForMode(mode, config) {
   if (mode === "local")
     return "none";
   if (mode === "cloud")
-    return config.cloudApiUrl ? "hosted_control_plane_contract" : "unconfigured";
+    return config.apiUrl ? "hosted_control_plane_contract" : "unconfigured";
   if (config.databaseUrlPresent)
     return "postgres_contract";
   if (config.apiUrl)
@@ -265,26 +260,22 @@ function buildDeploymentStatus(opts = {}) {
   const active = resolveLoopDeploymentMode(env);
   const deploymentMode = opts.perspective ?? active.deploymentMode;
   const config = loopControlPlaneConfig(env);
-  const rawApiUrl = deploymentMode === "cloud" ? config.cloudApiUrl : config.apiUrl;
-  const apiUrl = displayControlPlaneUrl(rawApiUrl);
+  const apiUrl = displayControlPlaneUrl(config.apiUrl);
   const controlPlaneKind = deploymentMode === "local" ? "none" : deploymentMode;
-  const deploymentAuthTokenPresent = deploymentMode === "cloud" ? config.cloudAuthTokenPresent : deploymentMode === "self_hosted" ? config.apiAuthTokenPresent : false;
-  const controlPlaneConfigured = deploymentMode === "local" ? false : deploymentMode === "self_hosted" ? Boolean(config.apiUrl || config.databaseUrlPresent) : Boolean(config.cloudApiUrl && deploymentAuthTokenPresent);
+  const deploymentAuthTokenPresent = deploymentMode === "cloud" ? config.apiKeyPresent : deploymentMode === "self_hosted" ? config.apiKeyPresent : false;
+  const controlPlaneConfigured = deploymentMode === "local" ? false : deploymentMode === "self_hosted" ? Boolean(config.apiUrl || config.databaseUrlPresent) : Boolean(config.apiUrl && deploymentAuthTokenPresent);
   const warnings = [];
   if (deploymentMode === "self_hosted" && !controlPlaneConfigured) {
-    warnings.push("self_hosted mode needs LOOPS_API_URL or LOOPS_DATABASE_URL before it can become authoritative");
+    warnings.push("self_hosted mode needs HASNA_LOOPS_API_URL or HASNA_LOOPS_DATABASE_URL before it can become authoritative");
   }
   if (deploymentMode === "self_hosted" && config.databaseUrlPresent && !config.apiUrl) {
-    warnings.push("LOOPS_DATABASE_URL selects the self_hosted storage contract; loops-runner still needs LOOPS_API_URL to claim remote work");
+    warnings.push("HASNA_LOOPS_DATABASE_URL selects the self_hosted storage contract; loops-runner still needs HASNA_LOOPS_API_URL to claim remote work");
   }
-  if (deploymentMode === "cloud" && config.apiUrl && !config.cloudApiUrl) {
-    warnings.push("LOOPS_API_URL selects self_hosted; cloud mode uses LOOPS_CLOUD_API_URL");
+  if (deploymentMode === "cloud" && !config.apiUrl) {
+    warnings.push("cloud mode needs HASNA_LOOPS_API_URL before it can become ready");
   }
-  if (deploymentMode === "cloud" && !config.cloudApiUrl) {
-    warnings.push("cloud mode is a public contract until LOOPS_CLOUD_API_URL is configured");
-  }
-  if (deploymentMode === "cloud" && config.cloudApiUrl && !deploymentAuthTokenPresent) {
-    warnings.push("cloud mode needs LOOPS_CLOUD_TOKEN or HASNA_LOOPS_CLOUD_TOKEN before it can become ready");
+  if (deploymentMode === "cloud" && config.apiUrl && !deploymentAuthTokenPresent) {
+    warnings.push("cloud mode needs HASNA_LOOPS_API_KEY before it can become ready");
   }
   if (opts.perspective && opts.perspective !== active.deploymentMode) {
     warnings.push(`active deployment mode is ${active.deploymentMode}; this is the ${opts.perspective} perspective`);
@@ -304,7 +295,7 @@ function buildDeploymentStatus(opts = {}) {
       configured: controlPlaneConfigured,
       apiUrl,
       databaseUrlPresent: config.databaseUrlPresent,
-      authTokenPresent: deploymentAuthTokenPresent
+      apiKeyPresent: deploymentAuthTokenPresent
     },
     runner: {
       required: deploymentMode !== "local",

package/dist/lib/route/fields.d.ts

@@ -15,6 +15,14 @@ export declare function firstTruthyField(records: Record<string, unknown>[], key
 export declare function automationRecords(data: Record<string, unknown>, metadata: Record<string, unknown>): Record<string, unknown>[];
 export declare function tagsFromValue(value: unknown): string[];
 export declare function taskEventTags(records: Record<string, unknown>[]): string[];
+/**
+ * First route-disallowed tag on a task, if any. Exposed so drains can exclude
+ * tasks that can never route (no-auto/blocked/manual/…) from the bounded
+ * candidate window *before* slicing, instead of letting them occupy scan slots
+ * every tick only to be rejected by eligibility — the "skip re-burns the window
+ * forever" half of the merge-lane decay.
+ */
+export declare function taskRouteDisallowedTag(tags: string[]): string | undefined;
 export declare function taskRouteEligibility(data: Record<string, unknown>, metadata: Record<string, unknown>): {
     eligible: boolean;
     reason?: string;

package/dist/lib/route/index.d.ts

@@ -1,6 +1,6 @@
 /**
  * Route engine: turns Hasna events, todos ready queues, and health/hygiene
- * findings into deduped, throttled OpenLoops workflow loops and todos tasks.
+ * findings into deduped, throttled Loops workflow loops and todos tasks.
  * Extracted from the CLI so commands stay thin and the SDK/daemon can reuse it.
  */
 export * from "./types.js";
@@ -11,7 +11,7 @@ export { GateError, normalizeLoopTargetForStorage, normalizeWorkflowForStorage,
 export { accountPoolFromOpts, normalizeAgentProvider, permissionModeFromOpts, providerAuthProfileFromOpts, providerRoutingPublic, resolveProviderRouting, roleAccountFromOpts, sandboxFromOpts, SUPPORTED_AGENT_PROVIDERS, type ProviderRoutingDecision, } from "./provider.js";
 export { checkProviderAdmission, parseCodewithAdmissionDiagnostics, providerActiveCapFromOpts, providerAdmissionPlanFromOpts, type CodewithAdmissionDiagnostics, type ProviderAdmissionDecision, type ProviderAdmissionPlan, } from "./provider-admission.js";
 export { prReviewRoutingDecision, type PrReviewRoutingDecision } from "./pr-review.js";
-export { hasThrottleLimits, normalizeRoutePath, routeThrottleDecision, routeThrottleLimitsFromOpts, type RouteThrottleDecision, type RouteThrottleLimits, } from "./throttle.js";
+export { hasThrottleLimits, normalizeRoutePath, routeThrottleDecision, routeThrottleLimitsFromInputs, routeThrottleLimitsFromOpts, type RouteThrottleDecision, type RouteThrottleLimits, } from "./throttle.js";
 export { generatedRouteSandboxPreflight, readEventEnvelopeInput, routeEventByKind, routeGenericEvent, routeTodosTaskEvent, todosTaskRouteTemplateId, } from "./route-event.js";
 export { drainTodosTaskRoutes, type DrainResult } from "./drain.js";
 export { buildHygieneRouteTasks, parseHygieneChecks, taskAutoRoute, upsertRouteTasks, type HygieneCheckKind, type HygieneRouteTask, type RouteTaskSpec, type UpsertRouteTasksOptions, } from "./route-tasks.js";

package/dist/lib/route/throttle.d.ts

@@ -26,6 +26,13 @@ export declare function routeThrottleLimitsFromOpts(opts: {
     maxActivePerProjectGroup?: string;
     maxPerProfile?: string;
 }): RouteThrottleLimits;
+export declare function routeThrottleLimitsFromInputs(opts: {
+    maxActive?: string;
+    maxActiveScope?: string;
+    maxActivePerProject?: string;
+    maxActivePerProjectGroup?: string;
+    maxPerProfile?: string;
+}, data: Record<string, unknown>, metadata: Record<string, unknown>): RouteThrottleLimits;
 export declare function hasThrottleLimits(limits: RouteThrottleLimits): boolean;
 export declare function normalizeRoutePath(value: string | undefined): string | undefined;
 export declare function routeProjectGroup(optsGroup: string | undefined, data: Record<string, unknown>, metadata: Record<string, unknown>): string | undefined;

package/dist/lib/route/types.d.ts

@@ -29,6 +29,9 @@ export interface TodosTaskRouteOptions {
     verifierIdleTimeout?: string;
     permissionMode?: string;
     sandbox?: string;
+    allowTool?: string[];
+    allowCommand?: string[];
+    safetyReason?: string;
     manualBreakGlass?: boolean;
     projectPath?: string;
     projectGroup?: string;

package/dist/lib/run-completion.d.ts

@@ -0,0 +1,18 @@
+export interface RunCompletionInput {
+    startedAt: string;
+    requestedFinishedAt?: string;
+    requestedDurationMs?: number;
+    serverNow: Date;
+}
+export interface NormalizedRunCompletion {
+    finishedAt: string;
+    durationMs: number | undefined;
+    updatedAt: string;
+}
+/**
+ * Treat the control-plane clock as authoritative while retaining a bounded
+ * runner timestamp as evidence. In the normal case, where startedAt is not
+ * ahead of the server clock, finishedAt is clamped into [startedAt, serverNow].
+ * A backwards server-clock jump fails safe at serverNow and yields duration 0.
+ */
+export declare function normalizeRunCompletion(input: RunCompletionInput): NormalizedRunCompletion;

package/dist/lib/scheduler.d.ts

@@ -1,5 +1,7 @@
 import type { ExecutorResult, Loop, LoopRun } from "../types.js";
+import { type CircuitBreakerThreshold } from "./advancement.js";
 import type { Store } from "./store.js";
+export { CIRCUIT_BREAKER_REASON_PREFIX, DEFAULT_CIRCUIT_BREAKER_THRESHOLD, MAX_RETRY_DELAY_MS, retryBackoffDelayMs, } from "./advancement.js";
 export interface SchedulerDeps {
     store: Store;
     runnerId: string;
@@ -25,6 +27,7 @@ export interface TickResult {
 export interface ClaimedLoopRun {
     loop: Loop;
     run: LoopRun;
+    claimToken: string;
 }
 export interface ClaimDueRunsResult extends TickResult {
     claims: ClaimedLoopRun[];
@@ -90,21 +93,11 @@ export declare function runLoopNow(deps: RunLoopNowDeps & {
 export declare function runLoopNow(deps: RunLoopNowDeps & {
     mode?: "inline";
 }): Promise<RunLoopNowExecuted>;
-export declare const MAX_RETRY_DELAY_MS: number;
-export declare const DEFAULT_CIRCUIT_BREAKER_THRESHOLD = 5;
-export declare const CIRCUIT_BREAKER_REASON_PREFIX = "circuit breaker open";
 export declare const MAX_SKIPS_PER_LOOP_PER_TICK = 10;
-/**
- * Exponential retry backoff with jitter:
- * delay = retryDelayMs * 2^(attempt-1) * (0.5 + random), capped at 6h.
- * Failures classified as provider-gated back off 4x harder, since hammering
- * a throttled, misconfigured, or unavailable provider only makes things worse.
- */
-export declare function retryBackoffDelayMs(loop: Loop, run: LoopRun, random?: () => number): number;
 export interface AdvanceLoopOptions {
     daemonLeaseId?: string;
     random?: () => number;
-    circuitBreakerThreshold?: number | ((loop: Loop) => number | undefined);
+    circuitBreakerThreshold?: CircuitBreakerThreshold;
     onRun?: (run: LoopRun) => void;
 }
 /**
@@ -123,6 +116,7 @@ export declare function advanceLoop(store: Store, loop: Loop, run: LoopRun, fini
 export declare function executeClaimedRun(deps: {
     store: Store;
     runnerId: string;
+    claimToken: string;
     loop: Loop;
     run: LoopRun;
     now?: () => Date;

package/dist/lib/storage/contract.d.ts

@@ -1,6 +1,6 @@
 import type { Store } from "../store.js";
 export type LoopStorageBackend = "sqlite" | "postgres";
-export type LoopStorageMethodName = "createLoop" | "getLoop" | "findLoopByName" | "requireLoop" | "listLoops" | "dueLoops" | "updateLoop" | "renameLoop" | "archiveLoop" | "unarchiveLoop" | "deleteLoop" | "upsertMigrationLoop" | "upsertMigrationRun" | "upsertMigrationWorkflow" | "createWorkflow" | "getWorkflow" | "listWorkflows" | "countWorkflows" | "archiveWorkflow" | "createWorkflowInvocation" | "getWorkflowInvocation" | "listWorkflowInvocations" | "upsertWorkflowWorkItem" | "getWorkflowWorkItem" | "listWorkflowWorkItems" | "countActiveWorkflowWorkItems" | "admitWorkflowWorkItem" | "createGoal" | "getGoal" | "listGoals" | "createGoalPlanNodes" | "listGoalPlanNodes" | "updateGoalStatus" | "updateGoalPlanNode" | "recordGoalEvent" | "listGoalRuns" | "createWorkflowRun" | "getWorkflowRun" | "listWorkflowRuns" | "listWorkflowStepRuns" | "getWorkflowStepRun" | "startWorkflowStepRun" | "recoverWorkflowRun" | "finalizeWorkflowStepRun" | "finalizeWorkflowRun" | "appendWorkflowEvent" | "listWorkflowEvents" | "recordRunProcess" | "createSkippedRun" | "getRun" | "getRunBySlot" | "claimRun" | "finalizeRun" | "heartbeatRunLease" | "listRuns" | "writeRunReceipt" | "getRunReceipt" | "listRunReceipts" | "recoverExpiredRunLeases" | "recoverExpiredRunLeasesDetailed" | "countLoops" | "countRuns" | "pruneHistory" | "acquireDaemonLease" | "heartbeatDaemonLease" | "releaseDaemonLease" | "getDaemonLease";
+export type LoopStorageMethodName = "createLoop" | "getLoop" | "findLoopByName" | "requireLoop" | "requireUniqueLoop" | "listLoops" | "dueLoops" | "updateLoop" | "advanceLoopIfCurrent" | "tripCircuitBreakerIfCurrent" | "renameLoop" | "archiveLoop" | "unarchiveLoop" | "deleteLoop" | "upsertMigrationLoop" | "upsertMigrationRun" | "upsertMigrationWorkflow" | "createWorkflow" | "getWorkflow" | "requireWorkflow" | "listWorkflows" | "countWorkflows" | "archiveWorkflow" | "createWorkflowInvocation" | "getWorkflowInvocation" | "listWorkflowInvocations" | "upsertWorkflowWorkItem" | "getWorkflowWorkItem" | "listWorkflowWorkItems" | "countActiveWorkflowWorkItems" | "admitWorkflowWorkItem" | "createGoal" | "getGoal" | "requireGoal" | "findGoalByContext" | "listGoals" | "createGoalPlanNodes" | "listGoalPlanNodes" | "updateGoalStatus" | "updateGoalPlanNode" | "recordGoalEvent" | "listGoalRuns" | "createWorkflowRun" | "getWorkflowRun" | "requireWorkflowRun" | "listWorkflowRuns" | "listWorkflowStepRuns" | "getWorkflowStepRun" | "isWorkflowRunTerminal" | "startWorkflowStepRun" | "markWorkflowStepPid" | "recordWorkflowStepProgress" | "recoverWorkflowRun" | "finalizeWorkflowStepRun" | "skipWorkflowStepRun" | "finalizeWorkflowRun" | "appendWorkflowEvent" | "listWorkflowEvents" | "recordRunProcess" | "createSkippedRun" | "getRun" | "getRunBySlot" | "nextRetryableRun" | "claimRun" | "finalizeRun" | "heartbeatRunLease" | "listRuns" | "listRecoveredLeaseRunsPage" | "writeRunReceipt" | "getRunReceipt" | "listRunReceipts" | "recoverExpiredRunLeases" | "recoverExpiredRunLeasesDetailed" | "countLoops" | "countRuns" | "pruneHistory" | "acquireDaemonLease" | "heartbeatDaemonLease" | "releaseDaemonLease" | "getDaemonLease";
 type AsyncStoreMethod<K extends LoopStorageMethodName> = Store[K] extends (...args: infer Args) => infer Result ? (...args: Args) => Promise<Result> : never;
 export interface LoopStorageContract extends Record<LoopStorageMethodName, (...args: never[]) => Promise<unknown>> {
     readonly backend: LoopStorageBackend;
@@ -10,9 +10,12 @@ export interface LoopStorageContract extends Record<LoopStorageMethodName, (...a
     getLoop: AsyncStoreMethod<"getLoop">;
     findLoopByName: AsyncStoreMethod<"findLoopByName">;
     requireLoop: AsyncStoreMethod<"requireLoop">;
+    requireUniqueLoop: AsyncStoreMethod<"requireUniqueLoop">;
     listLoops: AsyncStoreMethod<"listLoops">;
     dueLoops: AsyncStoreMethod<"dueLoops">;
     updateLoop: AsyncStoreMethod<"updateLoop">;
+    advanceLoopIfCurrent: AsyncStoreMethod<"advanceLoopIfCurrent">;
+    tripCircuitBreakerIfCurrent: AsyncStoreMethod<"tripCircuitBreakerIfCurrent">;
     renameLoop: AsyncStoreMethod<"renameLoop">;
     archiveLoop: AsyncStoreMethod<"archiveLoop">;
     unarchiveLoop: AsyncStoreMethod<"unarchiveLoop">;
@@ -22,6 +25,7 @@ export interface LoopStorageContract extends Record<LoopStorageMethodName, (...a
     upsertMigrationWorkflow: AsyncStoreMethod<"upsertMigrationWorkflow">;
     createWorkflow: AsyncStoreMethod<"createWorkflow">;
     getWorkflow: AsyncStoreMethod<"getWorkflow">;
+    requireWorkflow: AsyncStoreMethod<"requireWorkflow">;
     listWorkflows: AsyncStoreMethod<"listWorkflows">;
     countWorkflows: AsyncStoreMethod<"countWorkflows">;
     archiveWorkflow: AsyncStoreMethod<"archiveWorkflow">;
@@ -35,6 +39,8 @@ export interface LoopStorageContract extends Record<LoopStorageMethodName, (...a
     admitWorkflowWorkItem: AsyncStoreMethod<"admitWorkflowWorkItem">;
     createGoal: AsyncStoreMethod<"createGoal">;
     getGoal: AsyncStoreMethod<"getGoal">;
+    requireGoal: AsyncStoreMethod<"requireGoal">;
+    findGoalByContext: AsyncStoreMethod<"findGoalByContext">;
     listGoals: AsyncStoreMethod<"listGoals">;
     createGoalPlanNodes: AsyncStoreMethod<"createGoalPlanNodes">;
     listGoalPlanNodes: AsyncStoreMethod<"listGoalPlanNodes">;
@@ -44,12 +50,17 @@ export interface LoopStorageContract extends Record<LoopStorageMethodName, (...a
     listGoalRuns: AsyncStoreMethod<"listGoalRuns">;
     createWorkflowRun: AsyncStoreMethod<"createWorkflowRun">;
     getWorkflowRun: AsyncStoreMethod<"getWorkflowRun">;
+    requireWorkflowRun: AsyncStoreMethod<"requireWorkflowRun">;
     listWorkflowRuns: AsyncStoreMethod<"listWorkflowRuns">;
     listWorkflowStepRuns: AsyncStoreMethod<"listWorkflowStepRuns">;
     getWorkflowStepRun: AsyncStoreMethod<"getWorkflowStepRun">;
+    isWorkflowRunTerminal: AsyncStoreMethod<"isWorkflowRunTerminal">;
     startWorkflowStepRun: AsyncStoreMethod<"startWorkflowStepRun">;
+    markWorkflowStepPid: AsyncStoreMethod<"markWorkflowStepPid">;
+    recordWorkflowStepProgress: AsyncStoreMethod<"recordWorkflowStepProgress">;
     recoverWorkflowRun: AsyncStoreMethod<"recoverWorkflowRun">;
     finalizeWorkflowStepRun: AsyncStoreMethod<"finalizeWorkflowStepRun">;
+    skipWorkflowStepRun: AsyncStoreMethod<"skipWorkflowStepRun">;
     finalizeWorkflowRun: AsyncStoreMethod<"finalizeWorkflowRun">;
     appendWorkflowEvent: AsyncStoreMethod<"appendWorkflowEvent">;
     listWorkflowEvents: AsyncStoreMethod<"listWorkflowEvents">;
@@ -57,10 +68,12 @@ export interface LoopStorageContract extends Record<LoopStorageMethodName, (...a
     createSkippedRun: AsyncStoreMethod<"createSkippedRun">;
     getRun: AsyncStoreMethod<"getRun">;
     getRunBySlot: AsyncStoreMethod<"getRunBySlot">;
+    nextRetryableRun: AsyncStoreMethod<"nextRetryableRun">;
     claimRun: AsyncStoreMethod<"claimRun">;
     finalizeRun: AsyncStoreMethod<"finalizeRun">;
     heartbeatRunLease: AsyncStoreMethod<"heartbeatRunLease">;
     listRuns: AsyncStoreMethod<"listRuns">;
+    listRecoveredLeaseRunsPage: AsyncStoreMethod<"listRecoveredLeaseRunsPage">;
     writeRunReceipt: AsyncStoreMethod<"writeRunReceipt">;
     getRunReceipt: AsyncStoreMethod<"getRunReceipt">;
     listRunReceipts: AsyncStoreMethod<"listRunReceipts">;
@@ -100,6 +113,7 @@ export interface SchemaMigrationStorage {
     listAppliedMigrations(): Promise<AppliedStorageMigration[]>;
     migrate(opts?: {
         dryRun?: boolean;
+        through?: string;
     }): Promise<StorageMigrationResult>;
     close(): Promise<void>;
 }

package/dist/lib/storage/index.d.ts

@@ -2,6 +2,6 @@ export type { AppliedStorageMigration, AuditEventRecord, LoopStorageBackend, Loo
 export { SqliteLoopStorage, createSqliteLoopStorage } from "./sqlite.js";
 export { PostgresStorage, createPostgresStorage } from "./postgres.js";
 export type { PostgresQueryExecutor } from "./postgres.js";
-export { PostgresLoopStorage, createPostgresLoopStorage, NotImplementedError, } from "./postgres-loop-storage.js";
+export { PostgresLoopStorage, createPostgresLoopStorage, } from "./postgres-loop-storage.js";
 export { POSTGRES_MIGRATION_LEDGER_TABLE, POSTGRES_STORAGE_MIGRATIONS, checksumStorageSql, } from "./postgres-schema.js";
 export { Store } from "../store.js";