@hasna/loops 0.4.13 → 0.4.22

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

@@ -0,0 +1,14 @@
+import type { Loop, LoopRun, RunReceipt, RunReceiptMachine, WriteRunReceiptInput } from "../types.js";
+export declare const RUN_RECEIPT_SUMMARY_TEXT_CHARS = 4096;
+export declare const RUN_RECEIPT_MAX_IDS = 100;
+export declare const RUN_RECEIPT_MAX_EVIDENCE_PATHS = 100;
+export declare const RUN_RECEIPT_MAX_PATH_CHARS = 1024;
+export interface NormalizeRunReceiptOptions {
+    now?: Date;
+    loop?: Loop;
+    run?: LoopRun;
+    defaultMachine?: RunReceiptMachine;
+    defaultRepo?: string;
+    existing?: RunReceipt;
+}
+export declare function normalizeRunReceipt(input: WriteRunReceiptInput, opts?: NormalizeRunReceiptOptions): RunReceipt;

package/dist/lib/scheduler.d.ts

@@ -97,8 +97,8 @@ 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 rate_limit/auth back off 4x harder, since hammering
- * a throttled or misconfigured provider only makes things worse.
+ * 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 {
@@ -129,6 +129,9 @@ export declare function executeClaimedRun(deps: {
     beforeFinalize?: (loop: Loop, run: LoopRun) => void;
     daemonLeaseId?: string;
     execute?: (loop: Loop, run: LoopRun) => Promise<ExecutorResult>;
+    finalizeResult?: (result: ExecutorResult, loop: Loop, run: LoopRun) => Omit<ExecutorResult, "status"> & {
+        status: LoopRun["status"];
+    };
     onError?: (loop: Loop, error: unknown) => void;
 }): Promise<LoopRun>;
 export declare function claimDueRuns(deps: SchedulerDeps & {

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" | "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" | "recoverExpiredRunLeases" | "recoverExpiredRunLeasesDetailed" | "countLoops" | "countRuns" | "pruneHistory" | "acquireDaemonLease" | "heartbeatDaemonLease" | "releaseDaemonLease" | "getDaemonLease";
+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";
 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;
@@ -17,6 +17,9 @@ export interface LoopStorageContract extends Record<LoopStorageMethodName, (...a
     archiveLoop: AsyncStoreMethod<"archiveLoop">;
     unarchiveLoop: AsyncStoreMethod<"unarchiveLoop">;
     deleteLoop: AsyncStoreMethod<"deleteLoop">;
+    upsertMigrationLoop: AsyncStoreMethod<"upsertMigrationLoop">;
+    upsertMigrationRun: AsyncStoreMethod<"upsertMigrationRun">;
+    upsertMigrationWorkflow: AsyncStoreMethod<"upsertMigrationWorkflow">;
     createWorkflow: AsyncStoreMethod<"createWorkflow">;
     getWorkflow: AsyncStoreMethod<"getWorkflow">;
     listWorkflows: AsyncStoreMethod<"listWorkflows">;
@@ -58,6 +61,9 @@ export interface LoopStorageContract extends Record<LoopStorageMethodName, (...a
     finalizeRun: AsyncStoreMethod<"finalizeRun">;
     heartbeatRunLease: AsyncStoreMethod<"heartbeatRunLease">;
     listRuns: AsyncStoreMethod<"listRuns">;
+    writeRunReceipt: AsyncStoreMethod<"writeRunReceipt">;
+    getRunReceipt: AsyncStoreMethod<"getRunReceipt">;
+    listRunReceipts: AsyncStoreMethod<"listRunReceipts">;
     recoverExpiredRunLeases: AsyncStoreMethod<"recoverExpiredRunLeases">;
     recoverExpiredRunLeasesDetailed: AsyncStoreMethod<"recoverExpiredRunLeasesDetailed">;
     countLoops: AsyncStoreMethod<"countLoops">;

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

@@ -2,5 +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 { POSTGRES_MIGRATION_LEDGER_TABLE, POSTGRES_STORAGE_MIGRATIONS, checksumStorageSql, } from "./postgres-schema.js";
 export { Store } from "../store.js";