pi-harness-runtime 1.1.381 → 1.1.383

package/packages/health-monitor/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi/health-monitor",
-  "version": "1.1.381",
+  "version": "1.1.383",
   "type": "module",
   "description": "Health monitoring and auto-healing",
   "main": "dist/index.js",

package/packages/intent-analyzer/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi/intent-analyzer",
-  "version": "1.1.381",
+  "version": "1.1.383",
   "type": "module",
   "main": "src/index.ts",
   "exports": {

package/packages/jev-judge/dist/continuation-controller.d.ts

@@ -1,7 +1,4 @@
-import type { TodoItem, TodoContext } from "./todo-provider.js";
-/**
- * Continuation configuration
- */
+import type { TodoItem, TodoContext, TodoProvider } from "./todo-provider.js";
 export interface ContinuationConfig {
     /** Dispatch function to send messages to the agent (required) */
     dispatch: (content: string) => Promise<void>;
@@ -13,6 +10,46 @@ export interface ContinuationConfig {
     maxSteerAttempts?: number;
     /** Enable Jev for ambiguous cases */
     enableJev?: boolean;
+    /** Injectable todo provider (defaults to the pi-backed provider) */
+    todoProvider?: TodoProvider;
+    /**
+     * How long a dispatched continuation may stay "queued" before the guard is
+     * released automatically. Guards are normally released when the agent turn
+     * settles; this is the safety net for a lost settle event.
+     */
+    guardReleaseTimeoutMs?: number;
+    /**
+     * How long the guard stays armed after a guard release was DROPPED
+     * (it arrived while a dispatch was on the wire). Without this the guard
+     * would stay armed for the full `guardReleaseTimeoutMs` safety net and
+     * the auto-continue would stall for minutes.
+     */
+    guardReleaseAfterDropMs?: number;
+    /**
+     * Max successful dispatches per session across all items.
+     *
+     * The per-item budget (`maxSteerAttempts`) is reset when the work item
+     * changes, so alternating between two items would never exhaust it. This
+     * session-wide cap bounds such a run.
+     */
+    maxTotalSteerAttempts?: number;
+    /**
+     * How long the circuit breaker stays open after repeated send failures.
+     *
+     * After the cooldown a single trial dispatch is allowed again.
+     */
+    circuitBreakerCooldownMs?: number;
+    /**
+     * How many consecutive send failures open the circuit breaker.
+     */
+    maxConsecutiveFailures?: number;
+    /**
+     * How long a dispatch may stay on the wire before the in-flight guard is
+     * force-released.
+     *
+     * A dispatch that never settles must not block every later continuation.
+     */
+    inFlightTimeoutMs?: number;
 }
 /**
  * Continuation state
@@ -32,6 +69,35 @@ export interface ContinuationState {
     lastItemContinued: number | null;
     lastEvaluationResult: string | null;
 }
+/**
+ * Outcome of a steer attempt
+ */
+export interface SteerResult {
+    /** True when the continuation message was actually handed to the agent */
+    dispatched: boolean;
+    /** Why the dispatch was skipped (only set when dispatched is false) */
+    reason?: string;
+    /** Attempt counter for the item (successful dispatches only) */
+    attempts: number;
+    /** Number of dispatches that were blocked by a guard */
+    blockedDispatches: number;
+}
+/**
+ * Result of a guarded dispatch.
+ *
+ * `blocked` distinguishes the two reasons a dispatch does not happen:
+ * a guard skipped it (session busy, paused, duplicate, item completed) or
+ * the send itself failed. A blocked dispatch is counted separately and never
+ * consumes the attempt budget.
+ */
+export interface GuardedDispatchResult {
+    /** True when the continuation message was actually handed to the agent */
+    dispatched: boolean;
+    /** Why the dispatch did not happen (only set when dispatched is false) */
+    reason?: string;
+    /** True when a guard skipped the dispatch, false when the send itself failed */
+    blocked: boolean;
+}
 /**
  * Continuation result
  */
@@ -50,9 +116,49 @@ export declare class TodoContinuationController {
     private ctx;
     private config;
     private todoProvider;
+    /**
+     * How long a dispatched continuation may stay queued before the guard is
+     * released automatically (safety net for a lost agent_settled event).
+     */
+    private guardReleaseTimeoutMs;
+    /** Delay before the guard is released after a dropped mid-dispatch release */
+    private guardReleaseAfterDropMs;
     private state;
-    private _inFlight;
+    private _inFlightSeq;
+    private _dispatchSeq;
+    private _guardTimer;
+    private _blockedDispatches;
+    private _pendingGuardRelease;
+    private _cancelRequested;
+    private _lastDroppedGuardRelease;
+    private _stalledItemId;
+    private _consecutiveFailures;
+    private _maxConsecutiveFailures;
+    private _lastFailureAt;
+    private _circuitBreakerCooldownMs;
+    private _inFlightTimeoutMs;
+    private _attemptsByItem;
+    private _totalAttempts;
+    private _maxTotalSteerAttempts;
+    private _disposed;
+    /** True while a dispatch is on the wire */
+    private get inFlight();
     constructor(ctx: TodoContext, config?: ContinuationConfig);
+    /**
+     * Successful dispatches recorded for an item.
+     *
+     * The budget is per item: switching to a different item starts a fresh
+     * budget for that item, but the session-wide cap (`maxTotalSteerAttempts`)
+     * still bounds an alternating run.
+     */
+    private attemptsFor;
+    /**
+     * True while the circuit breaker forbids a send.
+     *
+     * After the cooldown a single trial dispatch is allowed again, so a
+     * transient transport outage does not stop auto-continue forever.
+     */
+    private breakerOpen;
     /**
      * Check if continuation is allowed (not paused, session idle)
      */
@@ -78,6 +184,18 @@ export declare class TodoContinuationController {
      * Clear continuation queue (called when work completes or starts)
      */
     clearQueue(): void;
+    /**
+     * Release the dispatch guard after a verified lifecycle transition.
+     *
+     * The guard is set when a continuation is handed to the agent and must be
+     * released once that turn has settled - otherwise every later dispatch is
+     * blocked while the attempt budget keeps being consumed.
+     */
+    releaseContinuationGuard(reason?: string): void;
+    /** Cancel the automatic guard-release timer */
+    private cancelGuardTimer;
+    /** Schedule an automatic guard release (safety net for a lost settle event) */
+    private scheduleGuardRelease;
     /**
      * Public method to evaluate and execute continuation
      * Called by external handlers (e.g., agent_settled)
@@ -86,8 +204,17 @@ export declare class TodoContinuationController {
     decide(): Promise<ContinuationResult>;
     /**
      * Continue a specific todo item
+     *
+     * Routed through the guarded dispatch so the in-flight guard, the
+     * duplicate-queue guard and the guard-release timer behave exactly like
+     * they do for an automatic continuation. A blocked or failed dispatch
+     * never consumes the attempt budget.
      */
     continueItem(item: TodoItem): Promise<void>;
+    /**
+     * Record a successful dispatch against the per-item and session budgets.
+     */
+    private recordAttempt;
     /**
      * Guarded dispatch - checks all conditions before sending
      * Uses in-flight guard to prevent race conditions
@@ -95,8 +222,12 @@ export declare class TodoContinuationController {
     private guardedDispatch;
     /**
      * Steer to continue a todo item
+     *
+     * The attempt budget is only consumed by dispatches that actually reached
+     * the agent. Dispatches blocked by a guard are counted separately so a
+     * blocked attempt can never exhaust the retry budget.
      */
-    steerToContinue(itemId: number): Promise<void>;
+    steerToContinue(itemId: number): Promise<SteerResult>;
     /**
      * Mark a todo item as complete
      */
@@ -113,13 +244,47 @@ export declare class TodoContinuationController {
      * Cleanup on shutdown
      */
     _cleanup(): void;
+    /**
+     * Public shutdown hook (used by the host on session shutdown).
+     *
+     * Releases the guard timer and the queue so a stopped session never keeps
+     * a timer alive or blocks a later continuation.
+     */
+    dispose(): void;
     /**
      * Get current state summary
+     *
+     * The item ids are reported as ids - the full TodoItem is only available
+     * from the (asynchronous) provider snapshot, so no partial object is
+     * presented as a TodoItem.
      */
     getState(): {
-        current: TodoItem | null;
-        next: TodoItem | null;
-        ready: number;
+        current: {
+            id: number;
+        } | null;
+        next: {
+            id: number;
+        } | null;
+    };
+    /**
+     * Full controller state (for diagnostics and tests)
+     */
+    getDiagnostics(): {
+        continuationQueued: boolean;
+        inFlight: boolean;
+        steerAttemptsForCurrentItem: number;
+        blockedDispatches: number;
+        consecutiveFailures: number;
+        circuitBreakerOpen: boolean;
+        totalAttempts: number;
+        lastItemContinued: number | null;
+        lastSteerMessage: string | null;
+        explicitPause: boolean;
+        userPaused: boolean;
+        pendingGuardRelease: string | null;
+        lastDroppedGuardRelease: string | null;
+        cancelRequested: boolean;
+        disposed: boolean;
     };
 }
 /**

package/packages/jev-judge/dist/continuation-controller.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"continuation-controller.d.ts","sourceRoot":"","sources":["../src/continuation-controller.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"continuation-controller.d.ts","sourceRoot":"","sources":["../src/continuation-controller.ts"],"names":[],"mappings":"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"}