@kici-dev/orchestrator 0.1.15 → 0.1.16

package/dist/stale-detector/stale-run-detector.d.ts

@@ -23,6 +23,8 @@ import type { ScalerManager } from '../scaler/manager.js';
 import type { Dispatcher } from '../agent/dispatcher.js';
 import type { AgentRegistry } from '../agent/registry.js';
 import type { HeldRunStore } from '../environments/held-runs.js';
+import type { StepApprovalBridge } from '../approvals/step-approval-bridge.js';
+import type { AccessLogWriter } from '../audit/access-log.js';
 export interface StaleRunDetectorDeps {
     db: Kysely<Database>;
     executionTracker: ExecutionTracker;
@@ -36,6 +38,12 @@ export interface StaleRunDetectorDeps {
     scanIntervalMs: number;
     /** Held run store for expiring overdue held runs. Optional -- if not set, held run cleanup is skipped. */
     heldRunStore?: HeldRunStore;
+    /** Step-approval bridge — notified when a step-scoped hold expires so the waiting agent fails the step. Optional. */
+    stepApprovalBridge?: StepApprovalBridge;
+    /** Fail a whole run when a job/workflow-scoped approval hold expires. Optional. */
+    failRun?: (runId: string, reason: string) => Promise<void>;
+    /** Access-log writer for the orchestrator audit stream. Optional -- if not set, expiry audit rows (`held_run.expire`) are skipped. */
+    accessLogWriter?: AccessLogWriter;
 }
 export declare class StaleRunDetector {
     private readonly db;
@@ -47,8 +55,18 @@ export declare class StaleRunDetector {
     private readonly staleThresholdMs;
     private readonly scanIntervalMs;
     private readonly heldRunStore?;
+    private readonly stepApprovalBridge?;
+    private readonly failRun?;
+    private readonly accessLogWriter?;
     private interval;
     constructor(deps: StaleRunDetectorDeps);
+    /**
+     * Expire overdue approval holds. Routes each overdue hold by scope BEFORE the
+     * bulk status flip: step-scoped holds notify the waiting agent (which fails
+     * the step), job/workflow-scoped holds fail the whole run. Then the bulk
+     * `expireOverdue()` flips every overdue row to `expired`.
+     */
+    private expireOverdueHolds;
     /**
      * Clean up orphaned jobs left in 'recovering' state from a previous orchestrator instance.
      *