@hasna/loops 0.3.2 → 0.3.4

package/dist/lib/executor.d.ts

@@ -1,10 +1,13 @@
-import type { ExecutableTarget, ExecutorResult, Loop, LoopRun } from "../types.js";
-export interface ExecuteOptions {
+import type { ExecutableTarget, ExecutorResult, Loop, LoopMachineRef, LoopRun, PersistGuardOptions } from "../types.js";
+export interface ExecuteOptions extends PersistGuardOptions {
     maxOutputBytes?: number;
     env?: NodeJS.ProcessEnv;
     log?: (message: string) => void;
     signal?: AbortSignal;
     onSpawn?: (pid: number) => void;
+    machine?: LoopMachineRef;
+    machineResolver?: (machine: LoopMachineRef) => LoopMachineRef;
+    machineCommandResolver?: (machineId: string, command: string) => MachineCommandPlan;
 }
 export interface ExecutionMetadata {
     loopId?: string;
@@ -21,6 +24,12 @@ export interface PreflightResult {
     accountProfile?: string;
     accountTool?: string;
 }
+interface MachineCommandPlan {
+    command: string;
+    args: string[];
+    source: string;
+}
 export declare function preflightTarget(target: ExecutableTarget, metadata?: ExecutionMetadata, opts?: ExecuteOptions): PreflightResult;
 export declare function executeTarget(target: ExecutableTarget, metadata?: ExecutionMetadata, opts?: ExecuteOptions): Promise<ExecutorResult>;
 export declare function executeLoop(loop: Loop, run: LoopRun, opts?: ExecuteOptions): Promise<ExecutorResult>;
+export {};

package/dist/lib/format.d.ts

@@ -1,10 +1,11 @@
-import type { Loop, LoopRun, WorkflowEvent, WorkflowRun, WorkflowSpec, WorkflowStepRun } from "../types.js";
+import type { ExecutorResult, Loop, LoopRun, WorkflowEvent, WorkflowRun, WorkflowSpec, WorkflowStepRun } from "../types.js";
 export declare function redact(value: string | undefined, visible?: number): string | undefined;
 export declare function textOutputBlocks(value: Pick<LoopRun | WorkflowStepRun, "stdout" | "stderr">, opts?: {
     indent?: string;
 }): string[];
 export declare function publicLoop(loop: Loop): Record<string, unknown>;
 export declare function publicRun(run: LoopRun, showOutput?: boolean): Record<string, unknown>;
+export declare function publicExecutorResult(result: ExecutorResult, showOutput?: boolean): Record<string, unknown>;
 export declare function publicWorkflow(workflow: WorkflowSpec): Record<string, unknown>;
 export declare function publicWorkflowRun(run: WorkflowRun): Record<string, unknown>;
 export declare function publicWorkflowStepRun(run: WorkflowStepRun, showOutput?: boolean): Record<string, unknown>;

package/dist/lib/machines.d.ts

@@ -0,0 +1,16 @@
+import type { LoopMachineRef } from "../types.js";
+export interface OpenMachineSummary {
+    id: string;
+    hostname?: string;
+    platform?: string;
+    user?: string;
+    workspacePath?: string;
+    route?: string;
+    local: boolean;
+    heartbeatStatus?: string;
+    tailscaleOnline?: boolean | null;
+    tags: string[];
+}
+export declare function listOpenMachines(): OpenMachineSummary[];
+export declare function resolveLoopMachine(machineId: string): LoopMachineRef;
+export declare function refreshLoopMachine(machine: LoopMachineRef): LoopMachineRef;

package/dist/lib/scheduler.d.ts

@@ -4,6 +4,9 @@ export interface SchedulerDeps {
     store: Store;
     runnerId: string;
     now?: () => Date;
+    beforeRun?: (loop: Loop, scheduledFor: string) => void;
+    beforeFinalize?: (loop: Loop, run: LoopRun) => void;
+    daemonLeaseId?: string;
     execute?: (loop: Loop, run: LoopRun) => Promise<ExecutorResult>;
     onError?: (loop: Loop, error: unknown) => void;
     onRun?: (run: LoopRun) => void;
@@ -17,13 +20,19 @@ export interface TickResult {
 }
 export declare function manualRunScheduledFor(loop: Loop, now?: Date): string;
 export declare function shouldAdvanceManualRun(loop: Loop, scheduledFor: string, now?: Date): boolean;
-export declare function advanceLoop(store: Store, loop: Loop, run: LoopRun, finishedAt: Date, succeeded: boolean): void;
+export type ManualRunSource = "ad_hoc" | "due_slot" | "retry_slot";
+export declare function manualRunSource(loop: Loop, scheduledFor: string, now?: Date): ManualRunSource;
+export declare function advanceLoop(store: Store, loop: Loop, run: LoopRun, finishedAt: Date, succeeded: boolean, opts?: {
+    daemonLeaseId?: string;
+}): void;
 export declare function executeClaimedRun(deps: {
     store: Store;
     runnerId: string;
     loop: Loop;
     run: LoopRun;
     now?: () => Date;
+    beforeFinalize?: (loop: Loop, run: LoopRun) => void;
+    daemonLeaseId?: string;
     execute?: (loop: Loop, run: LoopRun) => Promise<ExecutorResult>;
     onError?: (loop: Loop, error: unknown) => void;
 }): Promise<LoopRun>;

package/dist/lib/store.d.ts

@@ -1,4 +1,8 @@
 import type { CreateLoopInput, CreateWorkflowInput, Loop, LoopRun, LoopStatus, RunStatus, WorkflowEvent, WorkflowRun, WorkflowRunStatus, WorkflowSpec, WorkflowStepRun } from "../types.js";
+interface DaemonLeaseFence {
+    daemonLeaseId?: string;
+    now?: Date;
+}
 export interface DaemonLease {
     id: string;
     pid: number;
@@ -18,11 +22,13 @@ export interface CreateWorkflowRunInput {
     loopRun?: LoopRun;
     scheduledFor?: string;
     idempotencyKey?: string;
+    daemonLeaseId?: string;
 }
 export declare class Store {
     private db;
     constructor(path?: string);
     private migrate;
+    private assertDaemonLeaseFence;
     createLoop(input: CreateLoopInput, from?: Date): Loop;
     getLoop(id: string): Loop | undefined;
     findLoopByName(name: string): Loop | undefined;
@@ -32,7 +38,7 @@ export declare class Store {
         limit?: number;
     }): Loop[];
     dueLoops(now: Date): Loop[];
-    updateLoop(id: string, patch: Partial<Pick<Loop, "status" | "nextRunAt" | "retryScheduledFor" | "expiresAt">>): Loop;
+    updateLoop(id: string, patch: Partial<Pick<Loop, "status" | "nextRunAt" | "retryScheduledFor" | "expiresAt">>, opts?: DaemonLeaseFence): Loop;
     deleteLoop(idOrName: string): boolean;
     createWorkflow(input: CreateWorkflowInput): WorkflowSpec;
     getWorkflow(id: string): WorkflowSpec | undefined;
@@ -54,37 +60,39 @@ export declare class Store {
     listWorkflowStepRuns(workflowRunId: string): WorkflowStepRun[];
     getWorkflowStepRun(workflowRunId: string, stepId: string): WorkflowStepRun | undefined;
     isWorkflowRunTerminal(workflowRunId: string): boolean;
-    startWorkflowStepRun(workflowRunId: string, stepId: string): WorkflowStepRun;
-    markWorkflowStepPid(workflowRunId: string, stepId: string, pid: number): WorkflowStepRun;
+    startWorkflowStepRun(workflowRunId: string, stepId: string, opts?: DaemonLeaseFence): WorkflowStepRun;
+    markWorkflowStepPid(workflowRunId: string, stepId: string, pid: number, opts?: DaemonLeaseFence): WorkflowStepRun;
     recoverWorkflowRun(workflowRunId: string, reason?: string): {
         run: WorkflowRun;
         recoveredSteps: WorkflowStepRun[];
     };
-    finalizeWorkflowStepRun(workflowRunId: string, stepId: string, patch: Pick<WorkflowStepRun, "status" | "finishedAt" | "durationMs" | "stdout" | "stderr"> & Partial<Pick<WorkflowStepRun, "exitCode" | "error">>): WorkflowStepRun;
-    skipWorkflowStepRun(workflowRunId: string, stepId: string, reason: string): WorkflowStepRun;
-    finalizeWorkflowRun(workflowRunId: string, status: WorkflowRunStatus, patch?: Partial<Pick<WorkflowRun, "finishedAt" | "durationMs" | "error">>): WorkflowRun;
+    finalizeWorkflowStepRun(workflowRunId: string, stepId: string, patch: Pick<WorkflowStepRun, "status" | "finishedAt" | "durationMs" | "stdout" | "stderr"> & Partial<Pick<WorkflowStepRun, "exitCode" | "error">>, opts?: DaemonLeaseFence): WorkflowStepRun;
+    skipWorkflowStepRun(workflowRunId: string, stepId: string, reason: string, opts?: DaemonLeaseFence): WorkflowStepRun;
+    finalizeWorkflowRun(workflowRunId: string, status: WorkflowRunStatus, patch?: Partial<Pick<WorkflowRun, "finishedAt" | "durationMs" | "error">>, opts?: DaemonLeaseFence): WorkflowRun;
     cancelWorkflowRun(workflowRunId: string, reason?: string): WorkflowRun;
     appendWorkflowEvent(workflowRunId: string, eventType: string, stepId?: string, payload?: Record<string, unknown>): WorkflowEvent;
     listWorkflowEvents(workflowRunId: string, limit?: number): WorkflowEvent[];
     hasRunningRun(loopId: string): boolean;
-    markRunPid(id: string, pid: number, claimedBy?: string): LoopRun | undefined;
+    markRunPid(id: string, pid: number, claimedBy?: string, opts?: DaemonLeaseFence): LoopRun | undefined;
     private hasLiveWorkflowStepProcesses;
-    createSkippedRun(loop: Loop, scheduledFor: string, reason: string): LoopRun;
+    createSkippedRun(loop: Loop, scheduledFor: string, reason: string, opts?: DaemonLeaseFence): LoopRun;
     getRun(id: string): LoopRun | undefined;
     getRunBySlot(loopId: string, scheduledFor: string): LoopRun | undefined;
-    claimRun(loop: Loop, scheduledFor: string, runnerId: string, now?: Date): ClaimRunResult | undefined;
+    nextRetryableRun(loopId: string, maxAttempts: number, afterScheduledFor?: string): LoopRun | undefined;
+    claimRun(loop: Loop, scheduledFor: string, runnerId: string, now?: Date, opts?: DaemonLeaseFence): ClaimRunResult | undefined;
     finalizeRun(id: string, patch: Pick<LoopRun, "status" | "finishedAt" | "durationMs" | "stdout" | "stderr"> & Partial<Pick<LoopRun, "exitCode" | "error" | "pid">>, opts?: {
         claimedBy?: string;
         now?: Date;
+        daemonLeaseId?: string;
     }): LoopRun;
-    heartbeatRunLease(id: string, claimedBy: string, leaseMs: number, now?: Date): LoopRun | undefined;
+    heartbeatRunLease(id: string, claimedBy: string, leaseMs: number, now?: Date, opts?: DaemonLeaseFence): LoopRun | undefined;
     listRuns(opts?: {
         loopId?: string;
         status?: RunStatus;
         limit?: number;
     }): LoopRun[];
-    recoverExpiredRunLeases(now?: Date): LoopRun[];
-    expireLoops(now?: Date): Loop[];
+    recoverExpiredRunLeases(now?: Date, opts?: DaemonLeaseFence): LoopRun[];
+    expireLoops(now?: Date, opts?: DaemonLeaseFence): Loop[];
     countLoops(status?: LoopStatus): number;
     countRuns(status?: RunStatus): number;
     acquireDaemonLease(input: {
@@ -99,3 +107,4 @@ export declare class Store {
     getDaemonLease(): DaemonLease | undefined;
     close(): void;
 }
+export {};