Loading npm security reports…

llm-relay@0.81.0: AI-agent control-surface risk | LPM Firewall

registry / llm-relay / 0.81.0

llm-relay@0.81.0

Loopback bidirectional Anthropic/OpenAI API proxy with tool-call validation and multi-provider routing.

AI Security Review

scanned 28d ago · by lpm-firewall-ai

LPM flags this version as an AI-agent control-surface risk. An automatic global-install hook changes several AI-agent configuration surfaces. It installs provider, MCP, agent, and skill configuration without an explicit setup command.

Static reason

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

Trigger

Installing llm-relay globally through npm.

Impact

It can alter how Codex and other installed AI-agent hosts launch and route tools.

Mechanism

Postinstall writes and copies AI-agent configuration files.

Policy narrative

A global npm installation automatically runs a script that copies skills into three AI-agent host directories, writes a Codex provider and MCP server configuration, and creates or updates a relay agent. The installer fails open when host detection cannot run, so it can provision Codex anyway. These are foreign, broad AI-agent control-surface changes performed by lifecycle code rather than an explicit user setup command.

AI rationale

The package contains a postinstall hook that mutates multiple AI-agent host configurations during global installation. This meets the policy definition of unconsented lifecycle mutation of a foreign and broad AI-agent control surface.

Evidence

package.jsonscripts/install-skill.mjs~/.codex/config.toml~/.codex/agents/relay.toml~/.claude/skills/llm-relay~/.codex/skills/llm-relay~/.config/opencode/skills/llm-relay

Network endpoints1

Source & flagged code

17 flagged · loading source

package.jsonView file

•scripts.postinstall = node scripts/install-skill.mjs || node -e "process.stderr.write('llm-relay: the postinstall hook crashed, so the bundled host skills and Codex setup were NOT fully installed. The p...

Critical

Red Install Lifecycle Script

Install-time lifecycle script matches a deterministic static-gate block pattern.

package.jsonView on unpkg

•scripts.postinstall = node scripts/install-skill.mjs || node -e "process.stderr.write('llm-relay: the postinstall hook crashed, so the bundled host skills and Codex setup were NOT fully installed. The p...

High

Install Time Lifecycle Scripts

Package defines install-time lifecycle scripts.

package.jsonView on unpkg

scripts/install-skill.mjsView file

4* shipped source directory, and provision Codex's global provider plus the host-independent MCP L5: * dispatch entry point plus a Codex `relay` subagent file (`~/.codex/agents/relay.toml`) that L6: * pins no model, mirroring `src/setup-claude.ts`'s Claude `relay` agent. ... L9: * so that a repo-local `npm install` (dev checkout, CI) never touches the developer's L10: * ~/.claude, ~/.codex or the XDG config dir. Because the self-updater reinstalls the global L11: * package on a new version, every host's skill description and the missing Codex setup refresh ... L23: */ L24: import { copyFileSync, mkdirSync, existsSync, readFileSync, unlinkSync, writeFileSync } from "node:fs"; L25: import { join, dirname } from "node:path"; ... L60: * subagent docs (`/codex/agent-configuration/subagents`,

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/install-skill.mjsView on unpkg · L4

dist/claude-hook.jsView file

•Manifest-trigger-reachable source links an external AI-agent control path to a behavior-bearing write operation. import { relaystatepath } from "./state-paths.js"; import { existssync, mkdirsync, readfilesync, writefilesync } from "node:fs"; import { join } from "node:path"; import { homedir, tmpdir } from "node:os"; export const agent_hook_filename = "llm-relay-agent-offload.mjs"; export function claudehookpaths(home = homedir()) { if (process.env.vitest && home === homedir()) { const vitesthome = join(tmpdir(), "llm-relay-vitest"); return { settings: join(vitesthome, ".claude", "settings.json"), script: join(vitesthome, "hooks", agent_hook_filename), }; } return { settings: join(home, ".claude", "settings.json"),

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.

dist/claude-hook.jsView on unpkg

dist/config.js#virtual:normalized:round1View file

•stage = ast_semantic_analysis; reason = ast_parse_error; limitedFiles = 5

High

Semantic Analysis Limited

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

dist/config.js#virtual:normalized:round1View on unpkg

dist/self-update.jsView file

•matchType = normalized_sha256 matchedPackage = llm-relay@0.78.0 matchedPath = dist/self-update.js matchedIdentity = npm:bGxtLXJlbGF5:0.78.0 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/self-update.jsView on unpkg

dist/lane-quota-probe.jsView file

•matchType = normalized_sha256 matchedPackage = llm-relay@0.78.0 matchedPath = dist/lane-quota-probe.js matchedIdentity = npm:bGxtLXJlbGF5:0.78.0 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/lane-quota-probe.jsView on unpkg

dist/os-keyring.jsView file

•matchType = normalized_sha256 matchedPackage = llm-relay@0.78.0 matchedPath = dist/os-keyring.js matchedIdentity = npm:bGxtLXJlbGF5:0.78.0 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/os-keyring.jsView on unpkg

dist/refusal-interpretation.jsView file

•matchType = normalized_sha256 matchedPackage = llm-relay@0.78.0 matchedPath = dist/refusal-interpretation.js matchedIdentity = npm:bGxtLXJlbGF5:0.78.0 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/refusal-interpretation.jsView on unpkg

dist/secret-file-acl.jsView file

•matchType = normalized_sha256 matchedPackage = llm-relay@0.78.0 matchedPath = dist/secret-file-acl.js matchedIdentity = npm:bGxtLXJlbGF5:0.78.0 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/secret-file-acl.jsView on unpkg

dist/winenv.jsView file

•matchType = normalized_sha256 matchedPackage = llm-relay@0.78.0 matchedPath = dist/winenv.js matchedIdentity = npm:bGxtLXJlbGF5:0.78.0 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/winenv.jsView on unpkg

scripts/sync-tiers.mjsView file

•matchType = normalized_sha256 matchedPackage = llm-relay@0.78.0 matchedPath = scripts/sync-tiers.mjs matchedIdentity = npm:bGxtLXJlbGF5:0.78.0 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/sync-tiers.mjsView on unpkg

dist/accounting-store-schema.jsView file

•matchType = normalized_sha256 matchedPackage = llm-relay@0.78.0 matchedPath = dist/accounting-store-schema.js matchedIdentity = npm:bGxtLXJlbGF5:0.78.0 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/accounting-store-schema.jsView on unpkg

dist/dashboard-routes.jsView file

•matchType = normalized_sha256 matchedPackage = llm-relay@0.78.0 matchedPath = dist/dashboard-routes.js matchedIdentity = npm:bGxtLXJlbGF5:0.78.0 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/dashboard-routes.jsView on unpkg

dist/lane-cadence.jsView file

•matchType = normalized_sha256 matchedPackage = llm-relay@0.78.0 matchedPath = dist/lane-cadence.js matchedIdentity = npm:bGxtLXJlbGF5:0.78.0 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/lane-cadence.jsView on unpkg

dist/quota-observation.jsView file

•matchType = normalized_sha256 matchedPackage = llm-relay@0.78.0 matchedPath = dist/quota-observation.js matchedIdentity = npm:bGxtLXJlbGF5:0.78.0 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/quota-observation.jsView on unpkg

dist/reshaper.jsView file

•matchType = normalized_sha256 matchedPackage = llm-relay@0.78.0 matchedPath = dist/reshaper.js matchedIdentity = npm:bGxtLXJlbGF5:0.78.0 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/reshaper.jsView on unpkg