@trevonistrevon/pi-loop 0.1.0 → 0.1.3

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # Changelog
 
+## [0.1.2]
+
+- Added `onDone` parameter to `MonitorCreate` — auto-creates a completion loop so the agent is notified when a background process finishes, no polling needed
+- Updated tool descriptions and prompt guidelines for the MonitorCreate + LoopCreate pairing
+
+
+
+## [0.1.1]
+
+- Migrated peer dependencies from `@mariozechner/pi-*` to `@earendil-works/pi-*`
+- Fixed `.npmignore` to include `src/` and `dist/` directories
+
 ## [0.1.0] — Initial Release
 
 ### Tools

package/README.md

@@ -20,6 +20,7 @@ LoopDelete id="1"
 
 ```
 MonitorCreate command="tail -n0 -f build.log" description="Watch build"
+MonitorCreate command="python train.py" onDone="Analyze results and report best loss"
 MonitorList
 MonitorStop monitorId="1"
 ```
@@ -40,7 +41,7 @@ MonitorStop monitorId="1"
 | `LoopCreate` | Schedule a prompt on a cron timer, a pi event, or both with debounce |
 | `LoopList` | Show active loops with IDs, triggers, and next-fire times |
 | `LoopDelete` | Delete or pause a loop |
-| `MonitorCreate` | Run a background command, stream output as `monitor:output` events |
+| `MonitorCreate` | Run a background command, stream output as `monitor:output` events. Use `onDone` for auto-notify on completion |
 | `MonitorList` | Show monitors with status, uptime, and output line count |
 | `MonitorStop` | Stop a monitor (SIGTERM → 5s → SIGKILL) |
 

package/benchmarks/experiment-sim.js

@@ -0,0 +1,30 @@
+#!/usr/bin/env node
+/**
+ * Synthetic benchmark — mimics a research experiment with periodic progress output.
+ * Prints "iteration N/M, metric=0.XX" every 200ms for 30 iterations.
+ */
+
+const TOTAL = 30;
+const INTERVAL_MS = 200;
+
+let iteration = 0;
+
+const timer = setInterval(() => {
+  iteration++;
+  const metric = (Math.random() * 0.5 + 0.3).toFixed(4);
+  console.log(`iteration ${iteration}/${TOTAL}, loss=${metric}, timestamp=${Date.now()}`);
+
+  if (iteration >= TOTAL) {
+    console.log(`experiment complete: best loss=0.${Math.floor(Math.random() * 1000).toString().padStart(4, "0")}`);
+    clearInterval(timer);
+    process.exit(0);
+  }
+}, INTERVAL_MS);
+
+process.on("SIGTERM", () => {
+  console.log("experiment interrupted — saving checkpoint");
+  clearInterval(timer);
+  process.exit(0);
+});
+
+console.log("experiment starting: total_iterations=30, interval_ms=200");

package/dist/index.d.ts

@@ -13,5 +13,5 @@
  *   /loop    — Schedule a re-wake loop: /loop [interval] [prompt]
  *   /loops   — Interactive menu: view, create, cancel, settings
  */
-import type { ExtensionAPI } from "@mariozechner/pi-coding-agent";
+import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
 export default function (pi: ExtensionAPI): void;

package/dist/index.js

@@ -402,18 +402,30 @@ Use "pause" to temporarily stop a loop without removing it. Use "delete" to perm
     pi.registerTool({
         name: "MonitorCreate",
         label: "MonitorCreate",
-        description: `Start a background command and stream its output via pi events.
+        description: `Start a background command and stream its output via pi events. Optionally auto-notify when done.
 
-The monitor runs a shell command in the background. Each output line is emitted as a "monitor:output" pi event. Use this to watch logs, tail files, poll APIs, etc.
+The monitor runs a shell command in the background. Each output line is emitted as a "monitor:output" pi event. Use this to watch logs, tail files, poll APIs, run experiments, etc.
 
-Events emitted:
-- "monitor:output" — { monitorId, line, timestamp } for each output line
-- "monitor:done" — { monitorId, exitCode } on clean exit
-- "monitor:error" — { monitorId, error } on failure`,
+## When to Use
+
+Use this tool to:\n- Start a long-running experiment and get notified when it finishes\n- Watch a log file or build output in the background\n- Poll an API and stream results\n- Run any background command whose output you want to track
+
+## Events emitted
+
+- "monitor:output" — { monitorId, line, timestamp } for each output line\n- "monitor:done" — { monitorId, exitCode, outputLines } on clean exit\n- "monitor:error" — { monitorId, error } on failure
+
+## onDone — auto-notify on completion
+
+Pass onDone with a prompt and the monitor auto-creates a one-shot loop that fires when the process exits. The system reminder includes the exit code and output line count. No need to create a separate LoopCreate or poll MonitorList.\n\nExample: MonitorCreate command="python train.py" onDone="Check training results and report best loss"`,
+        promptGuidelines: [
+            "Use onDone to auto-notify when a long-running command finishes — no need for a separate LoopCreate.",
+            "When starting experiments or benchmarks, pass onDone so the agent automatically picks up the results.",
+        ],
         parameters: Type.Object({
             command: Type.String({ description: "Shell command to run in background" }),
             description: Type.Optional(Type.String({ description: "Human-readable description" })),
             timeout: Type.Optional(Type.Number({ description: "Auto-stop after N ms (default: 300000, 0 = no timeout)", default: 300000 })),
+            onDone: Type.Optional(Type.String({ description: "Prompt to run when the monitor completes. Auto-creates a one-shot completion loop — no need for a separate LoopCreate." })),
         }),
         execute(_toolCallId, params, _signal, _onUpdate, _ctx) {
             if (monitorManager.list().filter(m => m.status === "running").length >= 25) {
@@ -421,9 +433,16 @@ Events emitted:
             }
             const entry = monitorManager.create(params.command, params.description, params.timeout);
             widget.update();
+            let onDoneMsg = "";
+            if (params.onDone) {
+                const doneTrigger = { type: "event", source: "monitor:done", filter: JSON.stringify({ monitorId: entry.id }) };
+                const doneLoop = store.create(doneTrigger, params.onDone, { recurring: false });
+                triggerSystem.add(doneLoop);
+                onDoneMsg = `\nonDone loop #${doneLoop.id}: fires when monitor completes — no polling needed`;
+            }
             return Promise.resolve(textResult(`Monitor #${entry.id} started: ${entry.command.slice(0, 60)}\n` +
                 `Output stream: monitor:output (monitorId: ${entry.id})\n` +
-                `Timeout: ${params.timeout ? `${params.timeout / 1000}s` : "none"}`));
+                `Timeout: ${params.timeout ? `${params.timeout / 1000}s` : "none"}${onDoneMsg}`));
         },
     });
     // ──────────────────────────────────────────────────

package/dist/monitor-manager.d.ts

@@ -1,4 +1,4 @@
-import type { ExtensionAPI } from "@mariozechner/pi-coding-agent";
+import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
 import type { MonitorEntry, MonitorProcess } from "./types.js";
 export declare class MonitorManager {
     private pi;

package/dist/trigger-system.d.ts

@@ -1,4 +1,4 @@
-import type { ExtensionAPI } from "@mariozechner/pi-coding-agent";
+import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
 import type { CronScheduler } from "./scheduler.js";
 import type { LoopEntry } from "./types.js";
 export declare class TriggerSystem {

package/dist/ui/widget.js

@@ -1,4 +1,4 @@
-import { truncateToWidth } from "@mariozechner/pi-tui";
+import { truncateToWidth } from "@earendil-works/pi-tui";
 const MAX_VISIBLE = 6;
 export class LoopWidget {
     store;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@trevonistrevon/pi-loop",
-  "version": "0.1.0",
+  "version": "0.1.3",
   "description": "A pi extension for cron/event-based agent re-wake loops and background process monitoring.",
   "author": "trevonistrevon",
   "license": "MIT",
@@ -18,8 +18,8 @@
     "scheduler"
   ],
   "peerDependencies": {
-    "@mariozechner/pi-coding-agent": ">=0.70.5",
-    "@mariozechner/pi-tui": ">=0.70.5"
+    "@earendil-works/pi-coding-agent": "^0.75.5",
+    "@earendil-works/pi-tui": "^0.75.5"
   },
   "dependencies": {
     "typebox": "^1.1.34"
@@ -34,9 +34,9 @@
     "lint:fix": "biome check --fix src/ test/"
   },
   "devDependencies": {
+    "@biomejs/biome": "^2.4.13",
     "@types/node": "^25.0.0",
     "typescript": "^6.0.0",
-    "@biomejs/biome": "^2.4.13",
     "vitest": "^4.1.5"
   },
   "pi": {

package/src/index.ts

@@ -16,7 +16,7 @@
 
 import { randomUUID } from "node:crypto";
 import { join, resolve } from "node:path";
-import type { ExtensionAPI, ExtensionCommandContext, ExtensionContext } from "@mariozechner/pi-coding-agent";
+import type { ExtensionAPI, ExtensionCommandContext, ExtensionContext } from "@earendil-works/pi-coding-agent";
 import { Type } from "typebox";
 import { parseInterval } from "./loop-parse.js";
 import { MonitorManager } from "./monitor-manager.js";
@@ -439,18 +439,30 @@ Use "pause" to temporarily stop a loop without removing it. Use "delete" to perm
   pi.registerTool({
     name: "MonitorCreate",
     label: "MonitorCreate",
-    description: `Start a background command and stream its output via pi events.
+    description: `Start a background command and stream its output via pi events. Optionally auto-notify when done.
 
-The monitor runs a shell command in the background. Each output line is emitted as a "monitor:output" pi event. Use this to watch logs, tail files, poll APIs, etc.
+The monitor runs a shell command in the background. Each output line is emitted as a "monitor:output" pi event. Use this to watch logs, tail files, poll APIs, run experiments, etc.
 
-Events emitted:
-- "monitor:output" — { monitorId, line, timestamp } for each output line
-- "monitor:done" — { monitorId, exitCode } on clean exit
-- "monitor:error" — { monitorId, error } on failure`,
+## When to Use
+
+Use this tool to:\n- Start a long-running experiment and get notified when it finishes\n- Watch a log file or build output in the background\n- Poll an API and stream results\n- Run any background command whose output you want to track
+
+## Events emitted
+
+- "monitor:output" — { monitorId, line, timestamp } for each output line\n- "monitor:done" — { monitorId, exitCode, outputLines } on clean exit\n- "monitor:error" — { monitorId, error } on failure
+
+## onDone — auto-notify on completion
+
+Pass onDone with a prompt and the monitor auto-creates a one-shot loop that fires when the process exits. The system reminder includes the exit code and output line count. No need to create a separate LoopCreate or poll MonitorList.\n\nExample: MonitorCreate command="python train.py" onDone="Check training results and report best loss"`,
+    promptGuidelines: [
+      "Use onDone to auto-notify when a long-running command finishes — no need for a separate LoopCreate.",
+      "When starting experiments or benchmarks, pass onDone so the agent automatically picks up the results.",
+    ],
     parameters: Type.Object({
       command: Type.String({ description: "Shell command to run in background" }),
       description: Type.Optional(Type.String({ description: "Human-readable description" })),
       timeout: Type.Optional(Type.Number({ description: "Auto-stop after N ms (default: 300000, 0 = no timeout)", default: 300000 })),
+      onDone: Type.Optional(Type.String({ description: "Prompt to run when the monitor completes. Auto-creates a one-shot completion loop — no need for a separate LoopCreate." })),
     }),
 
     execute(_toolCallId, params, _signal, _onUpdate, _ctx) {
@@ -461,10 +473,18 @@ Events emitted:
       const entry = monitorManager.create(params.command, params.description, params.timeout);
       widget.update();
 
+      let onDoneMsg = "";
+      if (params.onDone) {
+        const doneTrigger: Trigger = { type: "event", source: "monitor:done", filter: JSON.stringify({ monitorId: entry.id }) };
+        const doneLoop = store.create(doneTrigger, params.onDone, { recurring: false });
+        triggerSystem.add(doneLoop);
+        onDoneMsg = `\nonDone loop #${doneLoop.id}: fires when monitor completes — no polling needed`;
+      }
+
       return Promise.resolve(textResult(
         `Monitor #${entry.id} started: ${entry.command.slice(0, 60)}\n` +
         `Output stream: monitor:output (monitorId: ${entry.id})\n` +
-        `Timeout: ${params.timeout ? `${params.timeout / 1000}s` : "none"}`
+        `Timeout: ${params.timeout ? `${params.timeout / 1000}s` : "none"}${onDoneMsg}`
       ));
     },
   });

package/src/monitor-manager.ts

@@ -1,6 +1,6 @@
 
 import { spawn } from "node:child_process";
-import type { ExtensionAPI } from "@mariozechner/pi-coding-agent";
+import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
 import type { MonitorEntry, MonitorProcess } from "./types.js";
 
 export class MonitorManager {

package/src/trigger-system.ts

@@ -1,4 +1,4 @@
-import type { ExtensionAPI } from "@mariozechner/pi-coding-agent";
+import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
 import type { CronScheduler } from "./scheduler.js";
 import type { LoopEntry } from "./types.js";
 

package/src/ui/widget.ts

@@ -1,4 +1,4 @@
-import { truncateToWidth } from "@mariozechner/pi-tui";
+import { truncateToWidth } from "@earendil-works/pi-tui";
 import type { MonitorManager } from "../monitor-manager.js";
 import type { CronScheduler } from "../scheduler.js";
 import type { LoopStore } from "../store.js";