@agimon-ai/doompi-runner 0.0.1-alpha.0

package/package.json

@@ -0,0 +1,335 @@
+{
+  "name": "@agimon-ai/doompi-runner",
+  "version": "0.0.1-alpha.0",
+  "description": "Pi bash tool replacement with background process supervision",
+  "homepage": "https://agimon.ai",
+  "license": "MIT",
+  "author": "Vuong Ngo",
+  "bin": {
+    "doom-runner": "./dist/bin/cli.mjs"
+  },
+  "files": [
+    "dist",
+    "skills"
+  ],
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "types": "./dist/index.d.mts",
+  "jsnext:main": "./dist/index.mjs",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.mts",
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.cjs"
+    },
+    "./bin/cli": {
+      "types": "./dist/bin/cli.d.mts",
+      "import": "./dist/bin/cli.mjs",
+      "require": "./dist/bin/cli.cjs"
+    },
+    "./bin/logSink": {
+      "types": "./dist/bin/logSink.d.mts",
+      "import": "./dist/bin/logSink.mjs",
+      "require": "./dist/bin/logSink.cjs"
+    },
+    "./bin/runnerHost": {
+      "types": "./dist/bin/runnerHost.d.mts",
+      "import": "./dist/bin/runnerHost.mjs",
+      "require": "./dist/bin/runnerHost.cjs"
+    },
+    "./cli/cliApp": {
+      "types": "./dist/cli/cliApp.d.mts",
+      "import": "./dist/cli/cliApp.mjs",
+      "require": "./dist/cli/cliApp.cjs"
+    },
+    "./compaction": {
+      "types": "./dist/compaction.d.mts",
+      "import": "./dist/compaction.mjs",
+      "require": "./dist/compaction.cjs"
+    },
+    "./config": {
+      "types": "./dist/config.d.mts",
+      "import": "./dist/config.mjs",
+      "require": "./dist/config.cjs"
+    },
+    "./container": {
+      "types": "./dist/container/index.d.mts",
+      "import": "./dist/container/index.mjs",
+      "require": "./dist/container/index.cjs"
+    },
+    "./extension": {
+      "types": "./dist/extension.d.mts",
+      "import": "./dist/extension.mjs",
+      "require": "./dist/extension.cjs"
+    },
+    "./extensions/pi": {
+      "types": "./dist/extensions/pi.d.mts",
+      "import": "./dist/extensions/pi.mjs",
+      "require": "./dist/extensions/pi.cjs"
+    },
+    "./ptyProvider": {
+      "types": "./dist/ptyProvider.d.mts",
+      "import": "./dist/ptyProvider.mjs",
+      "require": "./dist/ptyProvider.cjs"
+    },
+    "./reconcile": {
+      "types": "./dist/reconcile.d.mts",
+      "import": "./dist/reconcile.mjs",
+      "require": "./dist/reconcile.cjs"
+    },
+    "./services/AnsiScrub": {
+      "types": "./dist/services/AnsiScrub/index.d.mts",
+      "import": "./dist/services/AnsiScrub/index.mjs",
+      "require": "./dist/services/AnsiScrub/index.cjs"
+    },
+    "./services/AnsiScrub/ansiScrub": {
+      "types": "./dist/services/AnsiScrub/ansiScrub.d.mts",
+      "import": "./dist/services/AnsiScrub/ansiScrub.mjs",
+      "require": "./dist/services/AnsiScrub/ansiScrub.cjs"
+    },
+    "./services/BashRunService": {
+      "types": "./dist/services/BashRunService/index.d.mts",
+      "import": "./dist/services/BashRunService/index.mjs",
+      "require": "./dist/services/BashRunService/index.cjs"
+    },
+    "./services/BashRunService/BashRunService": {
+      "types": "./dist/services/BashRunService/BashRunService.d.mts",
+      "import": "./dist/services/BashRunService/BashRunService.mjs",
+      "require": "./dist/services/BashRunService/BashRunService.cjs"
+    },
+    "./services/Clock": {
+      "types": "./dist/services/Clock/index.d.mts",
+      "import": "./dist/services/Clock/index.mjs",
+      "require": "./dist/services/Clock/index.cjs"
+    },
+    "./services/Clock/SystemClock": {
+      "types": "./dist/services/Clock/SystemClock.d.mts",
+      "import": "./dist/services/Clock/SystemClock.mjs",
+      "require": "./dist/services/Clock/SystemClock.cjs"
+    },
+    "./services/Launcher": {
+      "types": "./dist/services/Launcher/index.d.mts",
+      "import": "./dist/services/Launcher/index.mjs",
+      "require": "./dist/services/Launcher/index.cjs"
+    },
+    "./services/Launcher/Launcher": {
+      "types": "./dist/services/Launcher/Launcher.d.mts",
+      "import": "./dist/services/Launcher/Launcher.mjs",
+      "require": "./dist/services/Launcher/Launcher.cjs"
+    },
+    "./services/Lifeline": {
+      "types": "./dist/services/Lifeline/index.d.mts",
+      "import": "./dist/services/Lifeline/index.mjs",
+      "require": "./dist/services/Lifeline/index.cjs"
+    },
+    "./services/Lifeline/NodeLifeline": {
+      "types": "./dist/services/Lifeline/NodeLifeline.d.mts",
+      "import": "./dist/services/Lifeline/NodeLifeline.mjs",
+      "require": "./dist/services/Lifeline/NodeLifeline.cjs"
+    },
+    "./services/Lifeline/watchdog": {
+      "types": "./dist/services/Lifeline/client.d.mts",
+      "import": "./dist/services/Lifeline/client.mjs",
+      "require": "./dist/services/Lifeline/client.cjs"
+    },
+    "./services/LogFile": {
+      "types": "./dist/services/LogFile/index.d.mts",
+      "import": "./dist/services/LogFile/index.mjs",
+      "require": "./dist/services/LogFile/index.cjs"
+    },
+    "./services/LogFile/LogFile": {
+      "types": "./dist/services/LogFile/LogFile.d.mts",
+      "import": "./dist/services/LogFile/LogFile.mjs",
+      "require": "./dist/services/LogFile/LogFile.cjs"
+    },
+    "./services/LogReader": {
+      "types": "./dist/services/LogReader/index.d.mts",
+      "import": "./dist/services/LogReader/index.mjs",
+      "require": "./dist/services/LogReader/index.cjs"
+    },
+    "./services/LogReader/LogReader": {
+      "types": "./dist/services/LogReader/LogReader.d.mts",
+      "import": "./dist/services/LogReader/LogReader.mjs",
+      "require": "./dist/services/LogReader/LogReader.cjs"
+    },
+    "./services/ProcessControl": {
+      "types": "./dist/services/ProcessControl/index.d.mts",
+      "import": "./dist/services/ProcessControl/index.mjs",
+      "require": "./dist/services/ProcessControl/index.cjs"
+    },
+    "./services/ProcessControl/NodeProcessControl": {
+      "types": "./dist/services/ProcessControl/NodeProcessControl.d.mts",
+      "import": "./dist/services/ProcessControl/NodeProcessControl.mjs",
+      "require": "./dist/services/ProcessControl/NodeProcessControl.cjs"
+    },
+    "./services/PtyHost": {
+      "types": "./dist/services/PtyHost/index.d.mts",
+      "import": "./dist/services/PtyHost/index.mjs",
+      "require": "./dist/services/PtyHost/index.cjs"
+    },
+    "./services/PtyHost/PtyHost": {
+      "types": "./dist/services/PtyHost/PtyHost.d.mts",
+      "import": "./dist/services/PtyHost/PtyHost.mjs",
+      "require": "./dist/services/PtyHost/PtyHost.cjs"
+    },
+    "./services/PtySpawner": {
+      "types": "./dist/services/PtySpawner/index.d.mts",
+      "import": "./dist/services/PtySpawner/index.mjs",
+      "require": "./dist/services/PtySpawner/index.cjs"
+    },
+    "./services/PtySpawner/NodePtySpawner": {
+      "types": "./dist/services/PtySpawner/NodePtySpawner.d.mts",
+      "import": "./dist/services/PtySpawner/NodePtySpawner.mjs",
+      "require": "./dist/services/PtySpawner/NodePtySpawner.cjs"
+    },
+    "./services/RmuxBackend": {
+      "types": "./dist/services/RmuxBackend/index.d.mts",
+      "import": "./dist/services/RmuxBackend/index.mjs",
+      "require": "./dist/services/RmuxBackend/index.cjs"
+    },
+    "./services/RmuxBackend/RmuxBackend": {
+      "types": "./dist/services/RmuxBackend/RmuxBackend.d.mts",
+      "import": "./dist/services/RmuxBackend/RmuxBackend.mjs",
+      "require": "./dist/services/RmuxBackend/RmuxBackend.cjs"
+    },
+    "./services/RunnerNamer": {
+      "types": "./dist/services/RunnerNamer/index.d.mts",
+      "import": "./dist/services/RunnerNamer/index.mjs",
+      "require": "./dist/services/RunnerNamer/index.cjs"
+    },
+    "./services/RunnerNamer/RunnerNamer": {
+      "types": "./dist/services/RunnerNamer/RunnerNamer.d.mts",
+      "import": "./dist/services/RunnerNamer/RunnerNamer.mjs",
+      "require": "./dist/services/RunnerNamer/RunnerNamer.cjs"
+    },
+    "./services/RunnerPaths": {
+      "types": "./dist/services/RunnerPaths/index.d.mts",
+      "import": "./dist/services/RunnerPaths/index.mjs",
+      "require": "./dist/services/RunnerPaths/index.cjs"
+    },
+    "./services/RunnerPaths/RunnerPaths": {
+      "types": "./dist/services/RunnerPaths/RunnerPaths.d.mts",
+      "import": "./dist/services/RunnerPaths/RunnerPaths.mjs",
+      "require": "./dist/services/RunnerPaths/RunnerPaths.cjs"
+    },
+    "./services/RunnerRegistry": {
+      "types": "./dist/services/RunnerRegistry/index.d.mts",
+      "import": "./dist/services/RunnerRegistry/index.mjs",
+      "require": "./dist/services/RunnerRegistry/index.cjs"
+    },
+    "./services/RunnerRegistry/RunnerRegistry": {
+      "types": "./dist/services/RunnerRegistry/RunnerRegistry.d.mts",
+      "import": "./dist/services/RunnerRegistry/RunnerRegistry.mjs",
+      "require": "./dist/services/RunnerRegistry/RunnerRegistry.cjs"
+    },
+    "./services/Spawner": {
+      "types": "./dist/services/Spawner/index.d.mts",
+      "import": "./dist/services/Spawner/index.mjs",
+      "require": "./dist/services/Spawner/index.cjs"
+    },
+    "./services/Spawner/NodeSpawner": {
+      "types": "./dist/services/Spawner/NodeSpawner.d.mts",
+      "import": "./dist/services/Spawner/NodeSpawner.mjs",
+      "require": "./dist/services/Spawner/NodeSpawner.cjs"
+    },
+    "./session": {
+      "types": "./dist/session.d.mts",
+      "import": "./dist/session.mjs",
+      "require": "./dist/session.cjs"
+    },
+    "./tool/bashTool": {
+      "types": "./dist/tool/bashTool.d.mts",
+      "import": "./dist/tool/bashTool.mjs",
+      "require": "./dist/tool/bashTool.cjs"
+    },
+    "./tool/responseEnvelope": {
+      "types": "./dist/tool/responseEnvelope.d.mts",
+      "import": "./dist/tool/responseEnvelope.mjs",
+      "require": "./dist/tool/responseEnvelope.cjs"
+    },
+    "./tool/schema": {
+      "types": "./dist/tool/schema.d.mts",
+      "import": "./dist/tool/schema.mjs",
+      "require": "./dist/tool/schema.cjs"
+    },
+    "./tui/bashRender": {
+      "types": "./dist/tui/bashRender.d.mts",
+      "import": "./dist/tui/bashRender.mjs",
+      "require": "./dist/tui/bashRender.cjs"
+    },
+    "./tui/format": {
+      "types": "./dist/tui/format.d.mts",
+      "import": "./dist/tui/format.mjs",
+      "require": "./dist/tui/format.cjs"
+    },
+    "./tui/runnerSpace": {
+      "types": "./dist/tui/runnerSpace.d.mts",
+      "import": "./dist/tui/runnerSpace.mjs",
+      "require": "./dist/tui/runnerSpace.cjs"
+    },
+    "./types": {
+      "types": "./dist/types.d.mts",
+      "import": "./dist/types.mjs",
+      "require": "./dist/types.cjs"
+    },
+    "./package.json": "./package.json"
+  },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "dependencies": {
+    "@rmux/sdk": "0.6.5",
+    "@xterm/headless": "6.0.0",
+    "inversify": "8.2.1",
+    "node-pty": "1.1.0",
+    "reflect-metadata": "0.2.2",
+    "typebox": "1.1.38",
+    "@agimon-ai/doompi-telemetry": "0.0.1-alpha.0",
+    "@agimon-ai/foundation-process-registry": "0.28.9",
+    "@agimon-ai/doompi-extension-contracts": "0.0.1-alpha.0",
+    "@agimon-ai/doompi-ui": "0.0.1-alpha.0"
+  },
+  "devDependencies": {
+    "@earendil-works/pi-coding-agent": "0.84.1",
+    "@earendil-works/pi-tui": "0.84.1",
+    "@types/node": "26.1.1",
+    "@vitest/coverage-v8": "4.1.10",
+    "tsdown": "0.22.14",
+    "typescript": "6.0.3",
+    "vitest": "4.1.10"
+  },
+  "peerDependencies": {
+    "@earendil-works/pi-coding-agent": "0.84.1",
+    "@earendil-works/pi-tui": "0.84.1"
+  },
+  "peerDependenciesMeta": {
+    "@earendil-works/pi-coding-agent": {
+      "optional": true
+    },
+    "@earendil-works/pi-tui": {
+      "optional": true
+    }
+  },
+  "optionalDependencies": {
+    "@agimon-ai/doompi-runner-rmux-linux-arm64": "0.0.1-alpha.0",
+    "@agimon-ai/doompi-runner-rmux-darwin-arm64": "0.0.1-alpha.0",
+    "@agimon-ai/doompi-runner-rmux-linux-x64": "0.0.1-alpha.0",
+    "@agimon-ai/doompi-runner-rmux-darwin-x64": "0.0.1-alpha.0"
+  },
+  "engines": {
+    "node": ">=22.19.0"
+  },
+  "pi": {
+    "extensions": [
+      "./dist/extensions/pi.mjs"
+    ]
+  },
+  "scripts": {
+    "build": "tsdown",
+    "test": "vitest --run",
+    "typecheck": "tsc --noEmit",
+    "lint": "oxlint . && oxfmt . --check",
+    "fixcode": "oxlint . --fix && oxfmt ."
+  }
+}

package/skills/doom-runner/SKILL.md

@@ -0,0 +1,69 @@
+---
+name: doom-runner
+description: 'Manage long-running commands started by bash: dev servers, watchers, builds, tails, and anything that prompts for input. Trigger when a command needs to outlive the current turn, when bash output was truncated, or when a background process needs to be inspected, followed, given input, or stopped.'
+---
+
+# doom-runner
+
+`bash` supervises what it starts. A command that outlives the background
+threshold keeps running instead of blocking the turn. Use the `doom-runner`
+CLI to manage it without adding another model tool.
+
+## Backgrounding
+
+- A command still running after 60 seconds (`DOOM_RUNNER_BG_THRESHOLD_MS`) is
+  moved to the background automatically. You get its unique ID and streaming
+  log path.
+- Pass `background: true` for commands you already know will not finish: dev
+  servers, watchers, `tail -f`. Waiting out the threshold first wastes a turn.
+- Pass `interactive: true` when the command will prompt for confirmation or
+  input. It runs under a terminal and backgrounds immediately. Answer it with
+  `doom-runner input <id> --text <text> --enter`, or use Runner Space.
+- Pass `timeout` (seconds) when you want a command killed rather than
+  supervised. A timeout above the threshold has no effect: the command is
+  promoted first.
+- Pass `name` to choose the runner name. A name already in use gets a numbered
+  suffix.
+
+## CLI
+
+Run the CLI directly, without starting it through another supervised runner.
+It inherits `PI_SESSION_ID` from the active Pi session and only accesses that
+session's runners. A manual shell without `PI_SESSION_ID` fails closed.
+
+Use the unique runner ID returned by `bash`:
+
+| Command                                            | Purpose                                        |
+| -------------------------------------------------- | ---------------------------------------------- |
+| `doom-runner list [--all]`                         | List active runners, or include completed ones |
+| `doom-runner status <id>`                          | Show command, state, backend, and log path     |
+| `doom-runner logs <id> [--lines N] [--follow]`     | Read or stream the saved log                   |
+| `doom-runner stop <id> [--reason <text>]`          | Stop one runner and keep its log               |
+| `doom-runner stop-all [--reason <text>]`           | Stop active runners owned by this Pi session   |
+| `doom-runner input <id> [--text <text>] [--enter]` | Send input to an interactive RMUX runner       |
+
+## Rules
+
+- **Read the log, do not re-run the command.** When output is truncated, the
+  full text is already on disk. Use `doom-runner logs <id>` or standard file
+  search tools against the reported path.
+- **Read the truncation notice before reading the file.** It states the real
+  file size and line count, so you do not read past the end.
+- **CLI access is session-scoped.** `list`, direct ID commands, and `stop-all`
+  only access runners owned by the inherited Pi session.
+- **`input` needs `interactive: true`.** A normal runner does not expose stdin.
+- **Stop what you no longer need.** Everything still running is stopped when
+  the session ends, but a forgotten dev server holds a port until then.
+- **Do not poll.** Check a runner when you have a reason to, not on a loop.
+
+## Where things live
+
+Run metadata and logs sit under
+`$PI_CODING_AGENT_DIR/doom-runner/<session-id>/{runs,logs}`. Without an
+override, `$PI_CODING_AGENT_DIR` defaults to `~/.pi/agent`. Completed metadata
+and logs remain readable for seven days. Logs rotate once at 5MB.
+
+RMUX is bundled for supported macOS and Linux platforms. doom-runner falls back
+to a system RMUX, then to its native launcher if needed.
+
+`SPC r r` opens Runner Space. Escape returns from logs or an attached terminal.