@hasna/loops 0.3.60 → 0.4.1

package/dist/lib/store.d.ts

@@ -46,6 +46,35 @@ export interface CreateGoalPlanNodeInput {
     priority?: number;
     tokenBudget?: number;
 }
+export interface RecordRunProcessInput {
+    pid: number;
+    pgid?: number;
+    processStartedAt?: string;
+}
+export interface RecoverExpiredRunLeasesResult {
+    /** Runs whose lease expired with no live process; marked abandoned. */
+    abandoned: LoopRun[];
+    /** Runs whose lease expired while their process (group) is still alive; lease deferred. */
+    deferred: LoopRun[];
+}
+export interface PruneHistoryOptions {
+    /** Delete terminal runs whose created_at is older than this many days. */
+    maxAgeDays?: number;
+    /** Always retain at least this many of the most recent runs per loop. */
+    keepPerLoop?: number;
+    /** Report what would be deleted without deleting anything. */
+    dryRun?: boolean;
+    /** Injectable clock for tests. */
+    now?: Date;
+}
+export interface PruneHistorySummary {
+    dryRun: boolean;
+    cutoff?: string;
+    keepPerLoop?: number;
+    loopRuns: number;
+    workflowRuns: number;
+    goalRuns: number;
+}
 export interface RecordGoalEventInput {
     goalId: string;
     turn?: number;
@@ -61,6 +90,8 @@ export declare class Store {
     private rootDir;
     constructor(path?: string);
     private migrate;
+    private migrations;
+    private createBaseSchema;
     /**
      * Add a column only if it does not already exist. Idempotent — avoids the
      * "duplicate column name" error that SQLite logs (via libsqlite3, before any
@@ -70,6 +101,8 @@ export declare class Store {
      */
     private addColumnIfMissing;
     private createWorkflowRunBackfillIndexes;
+    /** Run `fn` inside a write transaction unless the caller already opened one. */
+    private transact;
     private assertDaemonLeaseFence;
     private assertNoNestedWorkflowGoal;
     createLoop(input: CreateLoopInput, from?: Date): Loop;
@@ -179,6 +212,13 @@ export declare class Store {
         limit?: number;
     }): Goal[];
     createGoalPlanNodes(goalId: string, nodes: CreateGoalPlanNodeInput[], opts?: DaemonLeaseFence): GoalPlanNode[];
+    /**
+     * Insert a plan node, detecting (rather than silently ignoring) conflicts:
+     * an existing (plan_id, key) row means the node is already planned and is
+     * kept; a primary-key collision retries with a fresh id instead of dropping
+     * the node on the floor.
+     */
+    private insertGoalPlanNode;
     listGoalPlanNodes(goalIdOrPlanId: string): GoalPlanNode[];
     updateGoalStatus(goalId: string, status: GoalStatus, opts?: DaemonLeaseFence): Goal;
     addGoalUsage(goalId: string, tokens: number, timeUsedSeconds?: number, opts?: DaemonLeaseFence): Goal;
@@ -215,6 +255,11 @@ export declare class Store {
     hasRunningRun(loopId: string): boolean;
     hasRunningRunForSlot(loopId: string, scheduledFor: string): boolean;
     markRunPid(id: string, pid: number, claimedBy?: string, opts?: DaemonLeaseFence): LoopRun | undefined;
+    /**
+     * Record the spawned child's process identity (pid, process group id, start
+     * time) so recovery can signal the whole process group later.
+     */
+    recordRunProcess(runId: string, info: RecordRunProcessInput, opts?: DaemonLeaseFence): LoopRun | undefined;
     private hasLiveWorkflowStepProcesses;
     createSkippedRun(loop: Loop, scheduledFor: string, reason: string, opts?: DaemonLeaseFence): LoopRun;
     getRun(id: string): LoopRun | undefined;
@@ -237,12 +282,30 @@ export declare class Store {
         limit?: number;
         scanLimit?: number;
     }): LoopRun[];
+    /**
+     * Recover expired run leases and report both outcomes: runs abandoned (no
+     * live process) and runs deferred because their process (group) is still
+     * alive. Entries carry pid/pgid/processStartedAt so the daemon can signal
+     * orphaned process groups (SIGTERM then SIGKILL) after recovery.
+     */
+    recoverExpiredRunLeasesDetailed(now?: Date, opts?: DaemonLeaseFence & {
+        limit?: number;
+        scanLimit?: number;
+    }): RecoverExpiredRunLeasesResult;
     expireLoops(now?: Date, opts?: DaemonLeaseFence): Loop[];
     countLoops(status?: LoopStatus, opts?: {
         archived?: boolean;
         includeArchived?: boolean;
     }): number;
     countRuns(status?: RunStatus): number;
+    /**
+     * Delete old terminal run history: loop runs plus their attached workflow
+     * runs (step runs and events cascade), goal run events, and per-run manifest
+     * directories. At least one of maxAgeDays / keepPerLoop must be provided;
+     * when both are given a run is only deleted when it is older than the cutoff
+     * AND beyond the per-loop retention floor. Running runs are never touched.
+     */
+    pruneHistory(opts: PruneHistoryOptions): PruneHistorySummary;
     acquireDaemonLease(input: {
         id: string;
         pid: number;