@brettinternet/pi-loop 0.1.4 → 0.1.5

package/README.md

@@ -26,6 +26,8 @@ pi install npm:@brettinternet/pi-loop
 
 Durations use `ms`, `s`, `m`, `h`, or `d`. Delays range from 1 second to 24 hours. Timed loops run for at most 30 days. During a loop, `/loop time <duration>` switches to a deadline from now or resets the current deadline; timed mode requires a non-zero delay. `/loop <count>` switches back to a count of future iterations.
 
+A pending `/wait` or `until` watch keeps the current iteration's session alive until its wake-up turn settles (or it is cancelled). A paused wait or recurring watch holds the iteration until resumed or completed. Use `/loop delay` for a simple fixed gap between iterations; use `/wait` for a same-session follow-up and `until` for a condition that might become true earlier than a fixed deadline.
+
 Errors retry after 30 seconds, 1 minute, and 2 minutes, then pause. Aborting pauses the loop. `/loop pause` pauses after the active iteration settles; if the loop is between iterations, it pauses immediately. Resuming then starts the next iteration. An agent `loop_pause` request pauses mid-iteration for human blockers, and resuming continues that iteration. Recovery preserves the loop so you can resume or advance it.
 
 Chain commands in the prompt:

package/index.ts

@@ -639,6 +639,24 @@ export default function loopExtension(pi: ExtensionAPI): void {
   let pendingFailure: PendingFailure | undefined;
   let currentSessionManagerRef: unknown;
   let herdrBlocked = false;
+  const pendingWakes = new Map<string, boolean>();
+  let waitingForWake = false;
+  let wakeContext: ExtensionContext | undefined;
+
+  for (const channel of ["pi-until:busy", "pi-wait:busy"]) {
+    pi.events.on(channel, (value) => {
+      if (typeof value !== "boolean") return;
+      pendingWakes.set(channel, value);
+      if (!waitingForWake || [...pendingWakes.values()].some(Boolean)) return;
+      const ctx = wakeContext;
+      if (!ctx || !ctx.isIdle()) return;
+      const state = currentState(ctx);
+      if (!state || !statusIsActive(state) || transitionInFlight) return;
+      waitingForWake = false;
+      handledSettlementKey = stateKey(ctx, state);
+      scheduleContinuation(ctx, state);
+    });
+  }
 
   function reportHerdrBlocked(state: LoopState | undefined): void {
     const blocked = state?.status === "paused";
@@ -1523,6 +1541,9 @@ export default function loopExtension(pi: ExtensionAPI): void {
     clearCommandInterruption();
     pendingFailure = undefined;
     currentSessionManagerRef = ctx.sessionManager;
+    pendingWakes.clear();
+    waitingForWake = false;
+    wakeContext = ctx;
     transitionInFlight = false;
     handledSettlementKey = undefined;
     const loaded = latestStateFromContext(ctx);
@@ -1593,6 +1614,12 @@ export default function loopExtension(pi: ExtensionAPI): void {
       return;
     }
     if (handledSettlementKey === key) return;
+    if ([...pendingWakes.values()].some(Boolean)) {
+      waitingForWake = true;
+      wakeContext = ctx;
+      return;
+    }
+    waitingForWake = false;
     handledSettlementKey = key;
     scheduleContinuation(ctx, loaded);
   });
@@ -1604,6 +1631,9 @@ export default function loopExtension(pi: ExtensionAPI): void {
     clearCommandInterruption();
     pendingFailure = undefined;
     currentSessionManagerRef = ctx.sessionManager;
+    pendingWakes.clear();
+    waitingForWake = false;
+    wakeContext = ctx;
     handledSettlementKey = undefined;
     const loaded = latestStateFromContext(ctx);
     const owned = loaded && stateBelongsToContext(loaded, ctx) ? loaded : undefined;
@@ -1633,6 +1663,9 @@ export default function loopExtension(pi: ExtensionAPI): void {
     reportHerdrBlocked(undefined);
     clearWidget(ctx);
     currentSessionManagerRef = undefined;
+    waitingForWake = false;
+    wakeContext = undefined;
+    pendingWakes.clear();
   });
 
   pi.registerCommand("loop", {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@brettinternet/pi-loop",
-  "version": "0.1.4",
+  "version": "0.1.5",
   "description": "Run a prompt repeatedly in fresh Pi sessions",
   "type": "module",
   "license": "MIT",