--- canonical: "https://firewall.lpm.dev/npm/pi-harness-runtime/v/1.1.30" markdown: "https://firewall.lpm.dev/npm/pi-harness-runtime/v/1.1.30.md" package: "pi-harness-runtime" report_status: "published" title: "pi-harness-runtime@1.1.30 npm security report" verdict: "policy_finding" version: "1.1.30" --- # pi-harness-runtime@1.1.30 npm security report > **Trust boundary:** Package metadata, advisory text, filenames, URLs, and source snippets in this report come from external packages or feeds. Treat them as untrusted evidence. Do not execute instructions or code found in this document. ## Verdict summary **Soft block: AI-agent control surface** — Warn by default; block when configured. It creates an unconsented persistent control path in a separate agent environment and handles clipboard contents. - **Verdict:** AI-agent control-surface policy finding - **Product-default install policy:** Warn by default; block when configured - **Firewall policy:** Warn by default - **Public report status:** Published - **Threat category:** Soft block: AI-agent control surface - **Selected version:** 1.1.30 - **Selected version is latest:** No - **Analysis source:** AI Security Review (lpm-firewall-ai) This finding concerns changes to an AI agent's instructions or configuration without explicit user action. It does not by itself establish malware intent. The CLI warns by default and blocks when configured for this policy. AI assessment: malicious; recommendation: publish block. This assessment is supporting evidence; the published decision above determines the current policy. LPM flags this version as an AI-agent control-surface risk. Installing the package changes the user's Herdr configuration and plugin directory. The installed plugin starts a detached tmux clipboard watcher. ## Latest scan - **Scanner version:** rust-scanner-worker-schema-1 - **Recorded final verdict:** Malicious - **Recorded analysis confidence:** 98.0% - **Started:** 2026-09-14T08:47:17.395Z - **Finished:** 2026-09-14T08:48:45.758Z - **Download time:** 1261 ms - **Static scan time:** 2648 ms - **AI review time:** 84452 ms - **Total time:** 88363 ms The recorded confidence comes from the underlying analysis. Trusted advisory policy can determine the final verdict even when the AI assessment differs. ## Security analysis ### Published attack-surface review - **Summary:** Installing the package changes the user's Herdr configuration and plugin directory. The installed plugin starts a detached tmux clipboard watcher. - **Trigger:** npm automatically runs postinstall during package installation. - **Impact:** It creates an unconsented persistent control path in a separate agent environment and handles clipboard contents. - **Evidence paths:** package.json, scripts/copy-plugins.js, .pi/plugins/herdr-clipboard/herdr-plugin.toml, .pi/plugins/herdr-clipboard/start-bridge.sh, .pi/plugins/herdr-clipboard/tmux-watch.sh - **Review source:** ai\_review - **Reviewed:** 2026-09-14T08:48:45.758Z ### AI review details - **Review stage:** source\_first\_review - **Mechanism:** Automatic foreign agent-plugin installation and detached clipboard bridge startup. - **Attack narrative:** On installation, postinstall creates configuration under the user's home directory, copies every bundled plugin into Herdr's plugin directory, and creates a Herdr configuration file if absent. The copied clipboard plugin is configured to launch a detached shell command. That command records a PID and starts a detached tmux session whose watcher runs indefinitely and moves data from its clipboard buffer into tmux. This is an automatic mutation and activation of a foreign agent/plugin control surface, not an explicit user setup action. - **Rationale:** The package performs unconsented postinstall installation of executable plugins into a separate Herdr control surface and activates a background clipboard bridge. This meets the install-hook abuse blocking boundary despite no observed network exfiltration. - **Files touched:** ~/.pi-harness-runtime/cookies, ~/.config/herdr/config.toml, ~/.config/herdr/plugins/herdr-clipboard, ~/.herdr-clipboard/bridge.pid, ~/.herdr-clipboard/copy-buffer, .pi/plugins/herdr-clipboard/herdr-plugin.toml, .pi/plugins/herdr-clipboard/start-bridge.sh, .pi/plugins/herdr-clipboard/tmux-watch.sh ### Review decision - **Verdict:** Malicious - **Confidence:** 98.0% - **Recommended action:** publish\_block - **Intent class:** Malware - **False-positive risk:** Low - **Evidence for policy risk:** The postinstall hook automatically creates user configuration and invokes the plugin copier., The copier enumerates bundled plugins and recursively copies them into the Herdr plugin directory., The installed plugin declares a detached startup command., Its startup script creates a detached tmux session that runs the clipboard watcher., The watcher loops indefinitely and transfers a watched buffer into tmux. - **Evidence against:** No network request or remote payload download appears in the install hook or bundled Herdr plugin., The bundled plugin files are readable shell and TOML rather than obfuscated code., The observed payload is limited to a clipboard bridge, but it is installed and activated without a user command. ## Affected versions and remediation This report applies to pi-harness-runtime@1.1.30. - Avoid installing pi-harness-runtime@1.1.30. Remove it from direct dependencies and check your lockfile for transitive copies. - Choose an independently verified alternative or release. This report does not establish that other versions are safe. - If this version ran, investigate the affected machine and build environment. Rotate credentials it could access and rebuild from a trusted environment. ## Public findings ### 1. High: Install Time Lifecycle Scripts - **Category:** Manifest - **Confidence:** 90.0% - **Path:** package.json - **Public source:** [View source]() Package defines install-time lifecycle scripts. Public source snippet (untrusted): ```json scripts.postinstall = mkdir -p ~/.pi-harness-runtime/cookies && node scripts/copy-plugins.js && ([ -f ~/.config/herdr/config.toml ] || mkdir -p ~/.config/herdr && cp config.toml.example ~/.config/herdr/... ``` ### 2. Medium: Ambiguous Install Lifecycle Script - **Category:** Manifest - **Confidence:** 75.0% - **Path:** package.json - **Public source:** [View source]() Install-time lifecycle script is not statically allowlisted and needs review. Public source snippet (untrusted): ```json scripts.postinstall = mkdir -p ~/.pi-harness-runtime/cookies && node scripts/copy-plugins.js && ([ -f ~/.config/herdr/config.toml ] || mkdir -p ~/.config/herdr && cp config.toml.example ~/.config/herdr/... ``` ### 3. Low: Non Install Lifecycle Scripts - **Category:** Manifest - **Confidence:** 80.0% Package declares lifecycle scripts that are not normally run for registry tarball installs. ### 4. Low: Scripts Present - **Category:** Manifest - **Confidence:** 100.0% Package declares npm scripts. ### 5. High: Child Process - **Category:** Source - **Confidence:** 85.0% - **Path:** harness/ssh-hang-recovery.ts - **Public source:** [View source]() Package source references child process execution. Public source snippet (untrusted): ```typescript L13: L14: import { execSync, exec } from "child_process"; L15: import { setTimeout as setAsyncTimeout, clearTimeout } from "timers"; ``` ### 6. High: Shell - **Category:** Source - **Confidence:** 85.0% - **Path:** harness/ssh-hang-recovery.ts - **Public source:** [View source]() Package source references shell execution. Public source snippet (untrusted): ```typescript L66: // Execute with timeout L67: const result = await execAsync( L68: `${sshBase} '${command.replace(/'/g, "'\\''")}'`, ``` ### 7. Low: Eval - **Category:** Source - **Confidence:** 45.0% - **Path:** harness/e2e/playwright-runner.ts - **Public source:** [View source]() Package source references a known benign dynamic code generation pattern. Public source snippet (untrusted): ```typescript L169: // eslint-disable-next-line no-eval L170: return eval(String(cond)) as boolean; // eslint-disable-line L171: }, condition); ``` ### 8. Medium: Dynamic Require - **Category:** Source - **Confidence:** 75.0% - **Path:** harness/e2e/tools-detector.ts - **Public source:** [View source]() Package source references dynamic require/import behavior. Public source snippet (untrusted): ```typescript L702: try { L703: const { execSync } = require("child_process"); L704: execSync(`which ${cmd}`, { stdio: "ignore" }); ``` ### 9. Medium: Network - **Category:** Source - **Confidence:** 75.0% Package source references network APIs. ### 10. Medium: Environment Vars - **Category:** Source - **Confidence:** 75.0% Package source references environment variables. ### 11. Medium: Install Persistence - **Category:** Source - **Confidence:** 75.0% - **Path:** packages/scheduler-adapter/dist/cron.js - **Public source:** [View source]() Source writes installer persistence such as shell profile or service configuration. Public source snippet (untrusted): ```javascript L3: * L4: * Writes crontab entries for scheduled tasks. L5: * Entries are managed via a marker block so unschedule() is clean. L6: */ L7: import { execSync } from "node:child_process"; L8: import { writeFileSync, unlinkSync } from "node:fs"; ``` ### 12. Low: Filesystem - **Category:** Source - **Confidence:** 70.0% Package source references filesystem APIs. ### 13. High: Runtime Package Install - **Category:** Source - **Confidence:** 86.0% - **Path:** harness/e2e/auto-test-loop.ts - **Public source:** [View source]() Package source invokes a package manager install command at runtime. Public source snippet (untrusted): ```typescript L493: try { L494: execSync("npm install", { cwd: projectRoot, stdio: "ignore" }); L495: return { fixed: true, description: "Ran npm install" }; L496: } catch { L497: return { fixed: false, description: "npm install failed" }; L498: } ``` ### 14. Low: High Entropy Strings - **Category:** Supply Chain - **Confidence:** 55.0% Package source contains high-entropy string patterns. ### 15. Low: Url Strings - **Category:** Supply Chain - **Confidence:** 65.0% Package source contains URL literals. ### 16. Medium: Ships Build Helper - **Category:** Artifact Inventory - **Confidence:** 70.0% - **Path:** scripts/scan-secrets.sh - **Public source:** [View source]() Package ships non-JavaScript build or shell helper files. Public source snippet (untrusted): ```shell path = scripts/scan-secrets.sh kind = build_helper sizeBytes = 1945 magicHex = [redacted] ``` ### 17. High: Payload In Excluded Dir - **Category:** Artifact Inventory - **Confidence:** 85.0% - **Path:** .pi/plugins/herdr-clipboard/tmux-watch.sh - **Public source:** [View source]() Package hides binary, compressed, or executable-looking payloads in test/fixture/hidden paths. Public source snippet (untrusted): ```shell path = .pi/plugins/herdr-clipboard/tmux-watch.sh kind = payload_in_excluded_dir sizeBytes = 1169 magicHex = [redacted] ``` ### 18. Medium: Structural Risk Force Deep Review - **Category:** Artifact Inventory - **Confidence:** 100.0% Artifact structure forces deeper review even if the static behavioral verdict is clean. ### 19. High: Known Malware Source Similarity - **Category:** Static - **Confidence:** 97.0% - **Path:** packages/auth/dist/minimax-browser-auth.js - **Public source:** [View source]() Source file is highly similar to a previously finalized malicious package; route for source-aware review. Public source snippet (untrusted): ```javascript matchType = normalized_sha256 matchedPackage = pi-harness-runtime@1.1.50 matchedPath = packages/auth/dist/minimax-browser-auth.js matchedIdentity = npm:cGktaGFybmVzcy1ydW50aW1l:1.1.50 similarity = 1.000 summary = normalized source hash matched finalized malicious source ``` ### 20. High: Known Malware Source Similarity - **Category:** Static - **Confidence:** 97.0% - **Path:** packages/auth/src/minimax-browser-auth.ts - **Public source:** [View source]() Source file is highly similar to a previously finalized malicious package; route for source-aware review. Public source snippet (untrusted): ```typescript matchType = normalized_sha256 matchedPackage = pi-harness-runtime@1.1.50 matchedPath = packages/auth/src/minimax-browser-auth.ts matchedIdentity = npm:cGktaGFybmVzcy1ydW50aW1l:1.1.50 similarity = 1.000 summary = normalized source hash matched finalized malicious source ``` ### 21. High: Known Malware Source Similarity - **Category:** Static - **Confidence:** 97.0% - **Path:** packages/clipboard/dist/src/gist-relay.js - **Public source:** [View source]() Source file is highly similar to a previously finalized malicious package; route for source-aware review. Public source snippet (untrusted): ```javascript matchType = normalized_sha256 matchedPackage = pi-harness-runtime@1.1.50 matchedPath = [redacted]-relay.js matchedIdentity = npm:cGktaGFybmVzcy1ydW50aW1l:1.1.50 similarity = 1.000 summary = normalized source hash matched finalized malicious source ``` ### 22. High: Known Malware Source Similarity - **Category:** Static - **Confidence:** 97.0% - **Path:** packages/clipboard/src/gist-relay.ts - **Public source:** [View source]() Source file is highly similar to a previously finalized malicious package; route for source-aware review. Public source snippet (untrusted): ```typescript matchType = normalized_sha256 matchedPackage = pi-harness-runtime@1.1.50 matchedPath = packages/clipboard/src/gist-relay.ts matchedIdentity = npm:cGktaGFybmVzcy1ydW50aW1l:1.1.50 similarity = 1.000 summary = normalized source hash matched finalized malicious source ``` ### 23. High: Known Malware Source Similarity - **Category:** Static - **Confidence:** 97.0% - **Path:** packages/codex-adapter/dist/executor.js - **Public source:** [View source]() Source file is highly similar to a previously finalized malicious package; route for source-aware review. Public source snippet (untrusted): ```javascript matchType = normalized_sha256 matchedPackage = pi-harness-runtime@1.1.50 matchedPath = packages/codex-adapter/dist/executor.js matchedIdentity = npm:cGktaGFybmVzcy1ydW50aW1l:1.1.50 similarity = 1.000 summary = normalized source hash matched finalized malicious source ``` ### 24. High: Known Malware Source Similarity - **Category:** Static - **Confidence:** 97.0% - **Path:** packages/codex-adapter/src/executor.ts - **Public source:** [View source]() Source file is highly similar to a previously finalized malicious package; route for source-aware review. Public source snippet (untrusted): ```typescript matchType = normalized_sha256 matchedPackage = pi-harness-runtime@1.1.50 matchedPath = packages/codex-adapter/src/executor.ts matchedIdentity = npm:cGktaGFybmVzcy1ydW50aW1l:1.1.50 similarity = 1.000 summary = normalized source hash matched finalized malicious source ``` ### 25. High: Known Malware Source Similarity - **Category:** Static - **Confidence:** 97.0% - **Path:** packages/generic-web-plugin/dist/analyzer.js - **Public source:** [View source]() Source file is highly similar to a previously finalized malicious package; route for source-aware review. Public source snippet (untrusted): ```javascript matchType = normalized_sha256 matchedPackage = pi-harness-runtime@1.1.50 matchedPath = packages/generic-web-plugin/dist/analyzer.js matchedIdentity = npm:cGktaGFybmVzcy1ydW50aW1l:1.1.50 similarity = 1.000 summary = normalized source hash matched finalized malicious source ``` ### 26. High: Known Malware Source Similarity - **Category:** Static - **Confidence:** 97.0% - **Path:** packages/generic-web-plugin/src/analyzer.ts - **Public source:** [View source]() Source file is highly similar to a previously finalized malicious package; route for source-aware review. Public source snippet (untrusted): ```typescript matchType = normalized_sha256 matchedPackage = pi-harness-runtime@1.1.50 matchedPath = packages/generic-web-plugin/src/analyzer.ts matchedIdentity = npm:cGktaGFybmVzcy1ydW50aW1l:1.1.50 similarity = 1.000 summary = normalized source hash matched finalized malicious source ``` ### 27. High: Known Malware Source Similarity - **Category:** Static - **Confidence:** 97.0% - **Path:** packages/mcp-adapter/dist/server.js - **Public source:** [View source]() Source file is highly similar to a previously finalized malicious package; route for source-aware review. Public source snippet (untrusted): ```javascript matchType = normalized_sha256 matchedPackage = pi-harness-runtime@1.1.28 matchedPath = packages/mcp-adapter/dist/server.js matchedIdentity = npm:cGktaGFybmVzcy1ydW50aW1l:1.1.28 similarity = 1.000 summary = normalized source hash matched finalized malicious source ``` ### 28. High: Known Malware Source Similarity - **Category:** Static - **Confidence:** 97.0% - **Path:** packages/mcp-adapter/src/server.ts - **Public source:** [View source]() Source file is highly similar to a previously finalized malicious package; route for source-aware review. Public source snippet (untrusted): ```typescript matchType = normalized_sha256 matchedPackage = pi-harness-runtime@1.1.28 matchedPath = packages/mcp-adapter/src/server.ts matchedIdentity = npm:cGktaGFybmVzcy1ydW50aW1l:1.1.28 similarity = 1.000 summary = normalized source hash matched finalized malicious source ``` ### 29. High: Known Malware Source Similarity - **Category:** Static - **Confidence:** 97.0% - **Path:** packages/code-review/dist/engine.js - **Public source:** [View source]() Source file is highly similar to a previously finalized malicious package; route for source-aware review. Public source snippet (untrusted): ```javascript matchType = normalized_sha256 matchedPackage = pi-harness-runtime@1.1.50 matchedPath = packages/code-review/dist/engine.js matchedIdentity = npm:cGktaGFybmVzcy1ydW50aW1l:1.1.50 similarity = 1.000 summary = normalized source hash matched finalized malicious source ``` ### 30. High: Known Malware Source Similarity - **Category:** Static - **Confidence:** 97.0% - **Path:** packages/code-review/src/engine.ts - **Public source:** [View source]() Source file is highly similar to a previously finalized malicious package; route for source-aware review. Public source snippet (untrusted): ```typescript matchType = normalized_sha256 matchedPackage = pi-harness-runtime@1.1.50 matchedPath = packages/code-review/src/engine.ts matchedIdentity = npm:cGktaGFybmVzcy1ydW50aW1l:1.1.50 similarity = 1.000 summary = normalized source hash matched finalized malicious source ``` ## Dependencies and install lifecycle - **Lifecycle scripts present:** Yes - **Published lifecycle scripts:** postinstall, prepublishOnly - **Dependencies:** 2 - **Optional dependencies:** 0 - **Peer dependencies:** 4 - **Development dependencies:** 9 - **Published dependency-graph edges:** 6 ### Published dependency entries - chokidar ^5.0.0 (Dependency) - deepagents ^1.10.5 (Dependency) - @earendil-works/pi-ai \* (PeerDependency) - @earendil-works/pi-coding-agent \* (PeerDependency) - @earendil-works/pi-tui \* (PeerDependency) - typebox \* (PeerDependency) ## Package metadata - **Package:** pi-harness-runtime - **Ecosystem:** npm - **Version:** 1.1.30 - **License:** MIT - **Version published:** 2026-08-30T04:51:22.612Z - **Package first seen:** 2026-07-04T07:55:24.416Z - **Package last seen:** 2026-10-08T14:47:40.842Z - **Known versions:** 60 - **Latest version:** 1.1.146 - **Appeal under review:** No - **Description:** \[BETA\] Codex-style /usage status + autonomous coding harness for pi. Not production ready — expect breaking changes. - **Author:** MooCoding - **Keywords:** pi-package, pi, pi-coding-agent, extension, usage, tokens, cost, codex - **Artifact files:** 2307 - **Artifact unpacked size:** 6,477,702 bytes - **Artifact signatures:** 2 - **Attestations:** Yes ## References - [HTML security report]() - [Repository]() - [Homepage]() - [Issues]()