Loading npm security reports…

0xray@4.0.19: AI-agent control-surface risk | LPM Firewall

registry / 0xray / 4.0.19

0xray@4.0.19

Multi-agent orchestration and Codex governance for OpenCode, Hermes, Grok Build, and OpenClaw

AI Security Review

scanned 16d ago · by lpm-firewall-ai

LPM flags this version as an AI-agent control-surface risk. npm postinstall rewrites the consumer project agent files and, when HOME is the real user home, also writes Hermes and OpenClaw control files under that home. It enables those plugins and installs an OpenClaw pre-tool hook.

Static reason

High-risk behavior combination matched malicious policy.; source matched previously finalized malicious package; routed for review

Trigger

Automatic npm postinstall of 0xray in a consumer project whose HOME is not isolated and whose path is not an ephemeral temp root.

Impact

A dependency install changes OpenCode, Cursor, Hermes, and OpenClaw agent configuration and can gate later tool use through the installed hook without a separate setup command.

Mechanism

postinstall.cjs calls installAllBridges, which merges opencode.json and .mcp.json, writes .cursor/hooks.json, copies the Hermes plugin to the machine home, updates ~/.hermes/config.yaml, and copies a pre-tool hook into ~/.openclaw/hooks before enabling it.

Policy narrative

Installing 0xray runs postinstall.cjs. On a consumer project it writes AGENTS.md and then installAllBridges, which merges OpenCode and MCP config and adds Cursor hooks. If the process home is the real user home, it also copies the Hermes plugin into ~/.hermes, creates or updates ~/.hermes/config.yaml, enables the Hermes plugin, and copies an OpenClaw pre-tool hook into ~/.openclaw/hooks and enables that plugin. Those are foreign agent control surfaces changed by the install hook alone.

AI rationale

The postinstall hook mutates project and user-home AI agent control files for OpenCode, Cursor, Hermes, and OpenClaw without a separate user command. That is unconsented install-time control-surface mutation.

Evidence

package.jsonscripts/node/postinstall.cjsscripts/node/install-bridges.cjs

Source & flagged code

25 flagged

package.jsonView file

Lines 72-112json

72 "clean": "rm -rf dist tsconfig.tsbuildinfo tsconfig.*.tsbuildinfo",

73 "test": "vitest run",

74 "test:batch": "npm test",

75 "test:unit": "npm test -- src/__tests__/unit/config-loader.test.ts src/__tests__/unit/state-manager.test.ts src/__tests__/unit/state-manager-persistence.test.ts src/__tests__/unit/context-loader.test.ts src/__tests__/unit/pattern-analyzer.test.ts src/__tests__/unit/complexity-calibrator.test.ts",

76 "test:core-framework": "npm test -- src/__tests__/unit/self-direction-activation.test.ts src/__tests__/unit/ast-code-parser.test.ts src/__tests__/unit/v2-deletion-protection.test.ts",

77 "test:security": "npm test -- src/__tests__/unit/security/security-hardener.test.ts src/__tests__/unit/security/security-headers.test.ts src/__tests__/unit/security/security-auditor.test.ts",

78 "test:performance": "npm test -- src/__tests__/unit/monitoring.test.ts src/__tests__/unit/benchmark.test.ts src/__tests__/unit/analytics.test.ts",

79 "test:session-management": "npm test -- src/__tests__/unit/session-state-manager.test.ts src/__tests__/unit/session-security-validator.test.ts src/__tests__/unit/session-coordination-validator.test.ts src/__tests__/unit/session-migration-validator.test.ts src/__tests__/unit/session-migration-logic.test.ts",

80 "test:code-analysis": "npm test -- src/__tests__/unit/codebase-context-analyzer.test.ts src/__tests__/unit/dependency-graph-builder.test.ts src/__tests__/unit/rule-enforcer.test.ts src/__tests__/unit/codex-parser.test.ts src/__tests__/unit/codex-injector.test.ts",

81 "test:processors": "npm test -- src/__tests__/unit/processor-activation.test.ts src/__tests__/unit/typescript-compilation-processor.test.ts",

82 "test:miscellaneous": "npm test -- src/__tests__/unit/blocked-test.test.ts",

83 "test:quick": "npm test -- src/__tests__/integration/boot-orchestrator.integration.test.ts src/__tests__/unit/config-loader.test.ts src/__tests__/unit/state-manager.test.ts",

84 "test:comprehensive": "npm run typecheck && npm run test:unit && npm run test:core-framework && npm run test:security && npm run test:performance && npm run test:session-management && npm run test:code-analysis && npm run test:processors && npm run test:miscellaneous && npm test -- src/__tests__/unit/llm-governance-provider.test.ts src/__tests__/unit/mcp-server-smoke.test.ts src/__tests__/unit/cursor-hooks.test.ts src/__tests__/unit/host-vs-mill-score.test.ts",

85 "test:integration-all": "npm test -- src/__tests__/integration/",

86 "test:performance-all": "npm test -- src/__tests__/performance/ src/__tests__/unit/performance-system.test.ts src/__tests__/unit/benchmark.test.ts src/__tests__/unit/analytics.test.ts",

87 "test:agents-all": "echo 'Legacy agents test entry retired'",

88 "test:infrastructure": "npm test -- src/__tests__/infrastructure/",

89 "test:root": "npm test -- src/__tests__/integration/server.test.ts src/__tests__/framework-enforcement-integration.test.ts",

90 "test:pipelines": "node src/__tests__/pipeline/run-all-pipelines.mjs",

91 "test:full-suite": "npm run typecheck && npm run test:integration-all && npm run test:performance-all && npm run test:infrastructure && npm run test:root",

92 "postinstall": "node scripts/node/postinstall.cjs",

High

Install Time Lifecycle Scripts

Package defines install-time lifecycle scripts.

package.jsonView on unpkg · L92

Medium

Ambiguous Install Lifecycle Script

Install-time lifecycle script is not statically allowlisted and needs review.

package.jsonView on unpkg · L92

93 "setup-dev": "node scripts/node/setup-dev.cjs",

94 "prepare-consumer": "node scripts/node/prepare-consumer.cjs",

95 "typecheck": "tsc --noEmit",

96 "lint": "eslint -c tests/config/eslint.config.js src",

97 "lint:fix": "eslint src --fix",

98 "security-audit": "npm audit || true",

99 "test:security-audit": "npm run test:security",

100 "test:dependency-scan": "npm run security-audit",

101 "test:integration": "node scripts/mjs/test-consumer-readiness.mjs && node scripts/mjs/test-mcp-functionality.mjs",

102 "test:e2e": "node scripts/node/validate-mcp-connectivity.js && node scripts/node/validate-external-processes.js",

103 "live-feedback-session": "npx --yes tsx scripts/live-taskhandler-feedback-session.ts",

104 "validate": "echo \"[xray] Use 'npm test' or 'npm run test:comprehensive'.\"",

105 "validate:quick": "npm run validate",

106 "debug:inference:force": "XRAY_FORCE_MCP_GOVERNANCE=true XRAY_DEV_PATH=dist node dist/cli/index.js inference:run --force",

107 "validate:full": "npm run validate",

108 "test:unified": "node scripts/test/test-unified-framework.mjs",

109 "test:consumer": "node scripts/test/test-consumer-readiness.cjs",

110 "config:setup": "node scripts/config/utils.js setup-dev",

111 "monitoring:start": "node scripts/monitoring/daemon.js start",

112 "monitoring:stop": "node scripts/monitoring/daemon.js stop",

dist/security/security-scanner.jsView file

Lines 1-31javascript

1/**

2 * 0xRay Framework - Security Scanner

3 *

4 * Automated security vulnerability scanning and compliance validation

5 * Integrates with security tools and provides comprehensive security reports

6 */

7import { exec } from "child_process";

8import { promises as fs }

dist/core/boot-orchestrator.jsView file

Lines 152-192javascript

152 this.pluginServerRegistry = new PluginServerConfigRegistry();

153 const registered = this.pluginServerRegistry.registerAllPluginServers(this.pluginRegistry, { overwrite: false });

154

scripts/node/postinstall.cjsView file

Lines 19-59javascript

19} = require("../foundry/mint-suit.cjs");

21function structuredLog(component, action, status, details) {

22 const ts

dist/scripts/pre-command.mjsView file

•Runtime or CLI code links a write operation to an explicit external AI-agent control path: #!/usr/bin/env node import { existssync, mkdirsync, writefilesync, readfilesync } from "fs";

High

External Ai Agent Control Surface Mutation

Runtime or CLI source writes behavior-bearing configuration into a user or project AI-agent control surface.

dist/scripts/pre-command.mjsView on unpkg

scripts/foundry/mint-suit.cjsView file

•Manifest-trigger-reachable source links an external AI-agent control path to a behavior-bearing write operation. rn millplantprotocol.foundryplantdir(millpackageroot); } function emptyplantfiles() { return { skills: [], agents: [] }; } function catalogplant(kind, millpackageroot) { if (!kind || kind === "mill") { const spec = factory_plant_catalog.mill; return spec ? { skills: [...spec.skills], agents: [...spec.agents] } : emptyplantfiles(); } const parsed = millplantprotocol.parseplanttoken(kind); if (!parsed || parsed.builtin) { const spec = factory_plant_catalog.mill; return spec ? { skills: [...spec.skills], agents: [...spec.agents] } : emptyplantfiles(); } const pkgroot = millplantprotocol.resolvepackageroot(parsed.packagename, { targetdir: millpack

High

Trigger Reachable External Ai Agent Control Surface Mutation

Manifest-trigger-reachable source writes behavior-bearing configuration into a user or project AI-agent control surface.

scripts/foundry/mint-suit.cjsView on unpkg

dist/integrations/grok/grok-cli.jsView file

Lines 1-29javascript

1/**

2 * Grok CLI Integration for 0xRay

3 *

4 * This module provides the integration points for using 0xRay with the official Grok CLI.

5 *

6 * Primary mechanism: MCP (Model Context Protocol)

7 * Grok CLI can consume MCP servers. By registering the 0xRay MCP servers,

8 * users get access to Governance, skills, and other capabilities directly inside Grok conversations.

9 *

10 * Recommended registration (via npx or Grok's tooling):

dist/integrations/hermes-agent/conftest.pyView file

•path = dist/integrations/hermes-agent/conftest.py kind = build_helper sizeBytes = 409 magicHex = [redacted]

Medium

Ships Build Helper

Package ships non-JavaScript build or shell helper files.

dist/integrations/hermes-agent/conftest.pyView on unpkg

.opencode/init.shView file

•path = .opencode/init.sh kind = payload_in_excluded_dir sizeBytes = 8140 magicHex = [redacted]

High

Payload In Excluded Dir

Package hides binary, compressed, or executable-looking payloads in test/fixture/hidden paths.

.opencode/init.shView on unpkg

dist/cli/index.jsView file

•path = dist/cli/index.js kind = trigger_reachable_excluded_payload sizeBytes = 43488 triggerReachableSource = dist/cli/index.js excludedPayload = .opencode/init.sh

Critical

Trigger Reachable Excluded Directory Payload

A package entrypoint or install-reachable source explicitly loads and activates an executable-looking payload from a test, fixture, or hidden path.

dist/cli/index.jsView on unpkg

•matchType = normalized_sha256 matchedPackage = 0xray@4.0.18 matchedPath = dist/cli/index.js matchedIdentity = npm:MHhyYXk:4.0.18 similarity = 1.000 summary = normalized source hash matched finalized malicious source

High

Known Malware Source Similarity

Source file is highly similar to a previously finalized malicious package; route for source-aware review.

dist/cli/index.jsView on unpkg

dist/core/framework-logger.jsView file

•stage = ast_semantic_analysis; reason = ast_alias_growth_limit_exceeded; limitedFiles = 19

High

Semantic Analysis Limited

A bounded semantic-analysis stage reached its safety limit; remaining detectors completed, but this package requires AI review.

dist/core/framework-logger.jsView on unpkg

dist/cli/server.jsView file

•matchType = normalized_sha256 matchedPackage = 0xray@4.0.18 matchedPath = dist/cli/server.js matchedIdentity = npm:MHhyYXk:4.0.18 similarity = 1.000 summary = normalized source hash matched finalized malicious source

High

Known Malware Source Similarity

Source file is highly similar to a previously finalized malicious package; route for source-aware review.

dist/cli/server.jsView on unpkg

scripts/node/bridge-mcp-wiring.cjsView file

•matchType = normalized_sha256 matchedPackage = 0xray@4.0.18 matchedPath = scripts/node/bridge-mcp-wiring.cjs matchedIdentity = npm:MHhyYXk:4.0.18 similarity = 1.000 summary = normalized source hash matched finalized malicious source

High

Known Malware Source Similarity

Source file is highly similar to a previously finalized malicious package; route for source-aware review.

scripts/node/bridge-mcp-wiring.cjsView on unpkg

dist/cli/commands/mcp-install.jsView file

•matchType = normalized_sha256 matchedPackage = 0xray@4.0.18 matchedPath = dist/cli/commands/mcp-install.js matchedIdentity = npm:MHhyYXk:4.0.18 similarity = 1.000 summary = normalized source hash matched finalized malicious source

High

Known Malware Source Similarity

Source file is highly similar to a previously finalized malicious package; route for source-aware review.

dist/cli/commands/mcp-install.jsView on unpkg

dist/cli/commands/skill-install.jsView file

•matchType = normalized_sha256 matchedPackage = 0xray@4.0.18 matchedPath = dist/cli/commands/sk[redacted] matchedIdentity = npm:MHhyYXk:4.0.18 similarity = 1.000 summary = normalized source hash matched finalized malicious source

High

Known Malware Source Similarity

Source file is highly similar to a previously finalized malicious package; route for source-aware review.

dist/cli/commands/skill-install.jsView on unpkg

dist/integrations/hooks/pipeline-hook-runtime.mjsView file

•matchType = normalized_sha256 matchedPackage = 0xray@4.0.18 matchedPath = [redacted]-hook-runtime.mjs matchedIdentity = npm:MHhyYXk:4.0.18 similarity = 1.000 summary = normalized source hash matched finalized malicious source

High

Known Malware Source Similarity

Source file is highly similar to a previously finalized malicious package; route for source-aware review.

dist/integrations/hooks/pipeline-hook-runtime.mjsView on unpkg

scripts/node/install-bridges.cjsView file

•matchType = normalized_sha256 matchedPackage = 0xray@4.0.18 matchedPath = scripts/node/install-bridges.cjs matchedIdentity = npm:MHhyYXk:4.0.18 similarity = 1.000 summary = normalized source hash matched finalized malicious source

High

Known Malware Source Similarity

Source file is highly similar to a previously finalized malicious package; route for source-aware review.

scripts/node/install-bridges.cjsView on unpkg

dist/cli/commands/govern.jsView file

•matchType = normalized_sha256 matchedPackage = 0xray@4.0.18 matchedPath = dist/cli/commands/govern.js matchedIdentity = npm:MHhyYXk:4.0.18 similarity = 1.000 summary = normalized source hash matched finalized malicious source

High

Known Malware Source Similarity

Source file is highly similar to a previously finalized malicious package; route for source-aware review.

dist/cli/commands/govern.jsView on unpkg

dist/execution/opencode-cli-invoker.jsView file

•matchType = normalized_sha256 matchedPackage = 0xray@4.0.18 matchedPath = dist/execution/opencode-cli-invoker.js matchedIdentity = npm:MHhyYXk:4.0.18 similarity = 1.000 summary = normalized source hash matched finalized malicious source

High

Known Malware Source Similarity

Source file is highly similar to a previously finalized malicious package; route for source-aware review.

dist/execution/opencode-cli-invoker.jsView on unpkg

dist/integrations/plugins/plugin-integration.jsView file

•matchType = normalized_sha256 matchedPackage = 0xray@4.0.18 matchedPath = [redacted]-integration.js matchedIdentity = npm:MHhyYXk:4.0.18 similarity = 1.000 summary = normalized source hash matched finalized malicious source

High

Known Malware Source Similarity

Source file is highly similar to a previously finalized malicious package; route for source-aware review.

dist/integrations/plugins/plugin-integration.jsView on unpkg

dist/mcps/boot-orchestrator.server.jsView file

•matchType = normalized_sha256 matchedPackage = 0xray@4.0.18 matchedPath = dist/mcps/boot-orchestrator.server.js matchedIdentity = npm:MHhyYXk:4.0.18 similarity = 1.000 summary = normalized source hash matched finalized malicious source

High

Known Malware Source Similarity

Source file is highly similar to a previously finalized malicious package; route for source-aware review.

dist/mcps/boot-orchestrator.server.jsView on unpkg

Source & flagged code

25 flagged · loading source

package.jsonView file

•scripts.postinstall = node scripts/node/postinstall.cjs

High

Install Time Lifecycle Scripts

Package defines install-time lifecycle scripts.

package.jsonView on unpkg

•scripts.postinstall = node scripts/node/postinstall.cjs

Medium

Ambiguous Install Lifecycle Script

Install-time lifecycle script is not statically allowlisted and needs review.

package.jsonView on unpkg

dist/security/security-scanner.jsView file

6*/ L7: import { exec } from "child_process"; L8: import { promises as fs } from "fs";

High

Child Process

Package source references child process execution.

dist/security/security-scanner.jsView on unpkg · L6

11import { promptSecurityValidator, } from "./prompt-security-validator.js"; L12: const execAsync = promisify(exec); L13: export class SecurityScanner {

High

Shell

Package source references shell execution.

dist/security/security-scanner.jsView on unpkg · L11

dist/core/boot-orchestrator.jsView file

172try { L173: orchestratorModule = await import("../core/orchestrator"); L174: }

Medium

Dynamic Require

Package source references dynamic require/import behavior.

dist/core/boot-orchestrator.jsView on unpkg · L172

scripts/node/postinstall.cjsView file

39function deployManagedAgents(packageRoot, targetDir, log) { L40: const agentsConsumer = path.join(packageRoot, "AGENTS-consumer.md"); L41: const agentsDest = path.join(targetDir, "AGENTS.md"); L42: if (!fs.existsSync(agentsConsumer)) return; ... L52: } L53: fs.writeFileSync(agentsDest, content); L54: } else { L55: log("postinstall", "Skipped AGENTS.md (consumer-customized)", "info"); L56: }

Critical

Ai Agent Control Hijack

Source creates an unconsented AI-agent control surface through install-time mutation or a default unauthenticated remote skill channel.

scripts/node/postinstall.cjsView on unpkg · L39

dist/scripts/pre-command.mjsView file

•Runtime or CLI code links a write operation to an explicit external AI-agent control path: #!/usr/bin/env node import { existssync, mkdirsync, writefilesync, readfilesync } from "fs";

High

External Ai Agent Control Surface Mutation

Runtime or CLI source writes behavior-bearing configuration into a user or project AI-agent control surface.

dist/scripts/pre-command.mjsView on unpkg

scripts/foundry/mint-suit.cjsView file

High

Trigger Reachable External Ai Agent Control Surface Mutation

Manifest-trigger-reachable source writes behavior-bearing configuration into a user or project AI-agent control surface.

scripts/foundry/mint-suit.cjsView on unpkg

dist/integrations/grok/grok-cli.jsView file

9* L10: * Recommended registration (via npx or Grok's tooling): L11: * npx 0xray grok install ... L19: import path from 'path'; L20: import { execSync } from 'child_process'; L21: import { createRequire } from 'module';

High

Runtime Package Install

Package source invokes a package manager install command at runtime.

dist/integrations/grok/grok-cli.jsView on unpkg · L9

•matchType = normalized_sha256 matchedPackage = 0xray@4.0.18 matchedPath = dist/integrations/grok/grok-cli.js matchedIdentity = npm:MHhyYXk:4.0.18 similarity = 1.000 summary = normalized source hash matched finalized malicious source

High

Known Malware Source Similarity

Source file is highly similar to a previously finalized malicious package; route for source-aware review.

dist/integrations/grok/grok-cli.jsView on unpkg

dist/integrations/hermes-agent/conftest.pyView file

•path = dist/integrations/hermes-agent/conftest.py kind = build_helper sizeBytes = 409 magicHex = [redacted]

Medium

Ships Build Helper

Package ships non-JavaScript build or shell helper files.

dist/integrations/hermes-agent/conftest.pyView on unpkg

.opencode/init.shView file

•path = .opencode/init.sh kind = payload_in_excluded_dir sizeBytes = 8140 magicHex = [redacted]

High

Payload In Excluded Dir

Package hides binary, compressed, or executable-looking payloads in test/fixture/hidden paths.

.opencode/init.shView on unpkg

dist/cli/index.jsView file

•path = dist/cli/index.js kind = trigger_reachable_excluded_payload sizeBytes = 43488 triggerReachableSource = dist/cli/index.js excludedPayload = .opencode/init.sh

Critical

Trigger Reachable Excluded Directory Payload

A package entrypoint or install-reachable source explicitly loads and activates an executable-looking payload from a test, fixture, or hidden path.

dist/cli/index.jsView on unpkg

High

Known Malware Source Similarity

Source file is highly similar to a previously finalized malicious package; route for source-aware review.

dist/cli/index.jsView on unpkg

dist/core/framework-logger.jsView file

•stage = ast_semantic_analysis; reason = ast_alias_growth_limit_exceeded; limitedFiles = 19

High

Semantic Analysis Limited

A bounded semantic-analysis stage reached its safety limit; remaining detectors completed, but this package requires AI review.

dist/core/framework-logger.jsView on unpkg

dist/cli/server.jsView file

High

Known Malware Source Similarity

Source file is highly similar to a previously finalized malicious package; route for source-aware review.

dist/cli/server.jsView on unpkg

scripts/node/bridge-mcp-wiring.cjsView file

High

Known Malware Source Similarity

Source file is highly similar to a previously finalized malicious package; route for source-aware review.

scripts/node/bridge-mcp-wiring.cjsView on unpkg

dist/cli/commands/mcp-install.jsView file

High

Known Malware Source Similarity

Source file is highly similar to a previously finalized malicious package; route for source-aware review.

dist/cli/commands/mcp-install.jsView on unpkg

dist/cli/commands/skill-install.jsView file

High

Known Malware Source Similarity

Source file is highly similar to a previously finalized malicious package; route for source-aware review.

dist/cli/commands/skill-install.jsView on unpkg

dist/integrations/hooks/pipeline-hook-runtime.mjsView file

High

Known Malware Source Similarity

Source file is highly similar to a previously finalized malicious package; route for source-aware review.

dist/integrations/hooks/pipeline-hook-runtime.mjsView on unpkg

scripts/node/install-bridges.cjsView file

High

Known Malware Source Similarity

Source file is highly similar to a previously finalized malicious package; route for source-aware review.

scripts/node/install-bridges.cjsView on unpkg

dist/cli/commands/govern.jsView file

High

Known Malware Source Similarity

Source file is highly similar to a previously finalized malicious package; route for source-aware review.

dist/cli/commands/govern.jsView on unpkg

dist/execution/opencode-cli-invoker.jsView file

High

Known Malware Source Similarity

Source file is highly similar to a previously finalized malicious package; route for source-aware review.

dist/execution/opencode-cli-invoker.jsView on unpkg

dist/integrations/plugins/plugin-integration.jsView file

High

Known Malware Source Similarity

Source file is highly similar to a previously finalized malicious package; route for source-aware review.

dist/integrations/plugins/plugin-integration.jsView on unpkg

dist/mcps/boot-orchestrator.server.jsView file

High

Known Malware Source Similarity

Source file is highly similar to a previously finalized malicious package; route for source-aware review.

dist/mcps/boot-orchestrator.server.jsView on unpkg