registry / @sentropic/h2a / 0.82.0

@sentropic/h2a@0.82.0

h2a — the unified CLI + core for human-to-agent coordination.

AI Security Review

scanned 2h ago · by lpm-firewall-ai

LPM treats this as warn-only first-party agent extension lifecycle risk. No confirmed malicious attack surface or install-time compromise was found. The real risk is explicit user-command mutation of AI-agent skill/hook/plugin configuration for h2a coordination.

Static reason

No blocking static signals were detected.; previous stored version diff introduced dangerous source

Trigger

User runs `h2a install-skills`, `h2a host setup`, or `h2a host plugin --write/--scaffold`.

Impact

Adds h2a MCP/skill/hook integrations to local agent hosts; no automatic exfiltration or unconsented install-time control hijack observed.

Mechanism

first-party agent skill and hook configuration writes

Rationale

Because the agent-control writes are explicit, first-party setup commands rather than install-time or import-time mutation, this is not malicious under the firewall policy. It still warrants a warning due to agent extension lifecycle and control-surface changes when users invoke those commands.

Evidence

package.jsondist/bin.jsdist/index.jsdist/cli.jsdist/hosts/plugin.jsdist/runtime/upgrade/index.jsdist/runtime/local-files/paths.js~/.claude/skills/<skill>/SKILL.md~/.codex/skills/<skill>/SKILL.md~/.gemini/commands/<skill>.toml<project>/.claude/skills/<skill>/SKILL.md<project>/.codex/skills/<skill>/SKILL.md<project>/.gemini/commands/<skill>.toml<scaffold>/plugins/h2a-drumbeat/.codex-plugin/plugin.json<scaffold>/plugins/h2a-drumbeat/hooks/hooks.json<scaffold>/.agents/plugins/marketplace.json

Network endpoints5

127.0.0.1:8787/h2a/envelopes127.0.0.1:8788/h2a/drive127.0.0.1:8788/h2a/mirrorclaude.ai/api/mcp/auth_callbackclaude.com/api/mcp/auth_callback

Decision evidence

public snapshot

AI called this Suspicious at 88.0% confidence as Dangerous Capability with medium false-positive risk.

Evidence for warning

dist/cli.js exposes explicit `h2a install-skills --host <claude|codex|gemini|agy>` that writes bundled skills into user/project agent skill directories.
dist/cli.js `host plugin --write/--scaffold` writes Claude/Gemini/Codex hook/plugin config when invoked with flags.
dist/hosts/plugin.js renders host lifecycle hook commands for Stop and UserPromptSubmit that call `h2a drumbeat record` and `h2a drive receive`.
dist/runtime/upgrade/index.js can run `npm i -g @sentropic/h2a@latest`, but only through explicit upgrade or opt-in auto-upgrade flags.

Evidence against

package.json has no preinstall/install/postinstall lifecycle scripts; only `prepack`.
dist/bin.js only dispatches CLI subcommands; dynamic import is limited to optional `@sentropic/h2a-runtime` for non-native runtime verbs.
Network listeners/senders in dist/cli.js are user-invoked `remote`, `drive`, `mirror`, and MCP serve commands, binding localhost by default where applicable.
No import-time credential harvesting or exfiltration found in inspected entrypoints.
Agent config writes are first-party h2a setup commands, guarded by explicit flags and merge/refuse behavior rather than install-time mutation.

Behavioral surface

Source

ChildProcessCryptoDynamicRequireEnvironmentVarsFilesystemNetworkShell

Supply chain

HighEntropyStringsUrlStrings

ManifestNo manifest risk signals triggered.

scanned 139 file(s), 914 KB of source, external domains: 127.0.0.1, claude.ai, claude.com

Source & flagged code

2 flagged

dist/bin.jsView file

Lines 20-60javascript

20 }

21 return flags;

22}

23function runAsync(label, promise) {

24 promise.then((rc) => {

25 process.exitCode = rc;

26 }, (err) => {

27 process.stderr.write(`h2a ${label}: fatal: ${err.message}\n`);

28 process.exitCode = 1;

29 });

30}

31// Parité ② (double-consensus 2026-07-03) : `h2a` = LE driver global. Tout

32// premier-mot NON h2a-natif (cf. bin-routing.ts) est un verbe runtime (ex-remote)

33// et part en LAZY vers @sentropic/h2a-runtime. @sentropic/h2a ne dépend JAMAIS du

34// runtime (règle d'or) : import dynamique à spécifieur-string, seule frontière.

35async function dispatchRemote() {

36 // Spécifieur via variable typée `string` : tsc ne résout PAS statiquement ce

37 // package optionnel (sinon TS2307 car h2a n'en dépend pas — règle d'or).

38 const REMOTE_RUNTIME_PKG = "@sentropic/h2a-runtime";

39 let rt;

40 try {

41 rt = (await import(REMOTE_RUNTIME_PKG));

42 }

Medium

Dynamic Require

Package source references dynamic require/import behavior.

dist/bin.jsView on unpkg · L40

43 catch (err) {

44 if (err?.code === "ERR_MODULE_NOT_FOUND") {

45 process.stderr.write(`h2a ${argv[0]}: ce verbe requiert le runtime remote (sessions / k8s / tunnel).\n` +

46 " Installe-le : npm i -g @sentropic/h2a-runtime\n");

47 return 127;

48 }

49 throw err;

50 }

51 if (typeof rt.dispatch !== "function") {

52 process.stderr.write("h2a: @sentropic/h2a-runtime n'expose pas dispatch().\n");

53 return 1;

54 }

55 // dispatch = main(argv) : commander attend le style process.argv ([node, script, …]).

56 return rt.dispatch(process.argv);

57}

58// `mcp-serve` and `remote serve/send` are async (long-running loop or network);

59// the synchronous `runCli` cannot represent them, so we dispatch directly here.

60if (argv[0] === "mcp-serve") {

dist/cli.jsView file

•matchType = previous_version_dangerous_delta matchedPackage = @sentropic/h2a@0.81.0 matchedIdentity = npm:QHNlbnRyb3BpYy9oMmE:0.81.0 similarity = 0.850 summary = stored previous version shares package body but lacks this dangerous source file

High

Previous Version Dangerous Delta

This package version adds a dangerous source file absent from the previous stored version; route for source-aware review.

dist/cli.jsView on unpkg

Source & flagged code

2 flagged · loading source

dist/bin.jsView file

40try { L41: rt = (await import(REMOTE_RUNTIME_PKG)); L42: }

Medium

Dynamic Require

Package source references dynamic require/import behavior.

dist/bin.jsView on unpkg · L40

dist/cli.jsView file

High

Previous Version Dangerous Delta

This package version adds a dangerous source file absent from the previous stored version; route for source-aware review.

dist/cli.jsView on unpkg

Findings

1 High3 Medium4 Low

HighPrevious Version Dangerous Deltadist/cli.js

MediumDynamic Requiredist/bin.js

MediumNetwork

MediumEnvironment Vars

LowScripts Present

LowFilesystem

LowHigh Entropy Strings

LowUrl Strings

Source & flagged code

2 flagged

dist/bin.jsView file

Lines 20-60javascript

20 }

21 return flags;

22}

23function runAsync(label, promise) {

24 promise.then((rc) => {

25 process.exitCode = rc;

26 }, (err) => {

27 process.stderr.write(`h2a ${label}: fatal: ${err.message}\n`);

28 process.exitCode = 1;

29 });

30}

31// Parité ② (double-consensus 2026-07-03) : `h2a` = LE driver global. Tout

32// premier-mot NON h2a-natif (cf. bin-routing.ts) est un verbe runtime (ex-remote)

33// et part en LAZY vers @sentropic/h2a-runtime. @sentropic/h2a ne dépend JAMAIS du

34// runtime (règle d'or) : import dynamique à spécifieur-string, seule frontière.

35async function dispatchRemote() {

36 // Spécifieur via variable typée `string` : tsc ne résout PAS statiquement ce

37 // package optionnel (sinon TS2307 car h2a n'en dépend pas — règle d'or).

38 const REMOTE_RUNTIME_PKG = "@sentropic/h2a-runtime";

39 let rt;

40 try {

41 rt = (await import(REMOTE_RUNTIME_PKG));

42 }

Medium

Dynamic Require

Package source references dynamic require/import behavior.

dist/bin.jsView on unpkg · L40

43 catch (err) {

44 if (err?.code === "ERR_MODULE_NOT_FOUND") {

45 process.stderr.write(`h2a ${argv[0]}: ce verbe requiert le runtime remote (sessions / k8s / tunnel).\n` +

46 " Installe-le : npm i -g @sentropic/h2a-runtime\n");

47 return 127;

48 }

49 throw err;

50 }

51 if (typeof rt.dispatch !== "function") {

52 process.stderr.write("h2a: @sentropic/h2a-runtime n'expose pas dispatch().\n");

53 return 1;

54 }

55 // dispatch = main(argv) : commander attend le style process.argv ([node, script, …]).

56 return rt.dispatch(process.argv);

57}

58// `mcp-serve` and `remote serve/send` are async (long-running loop or network);

59// the synchronous `runCli` cannot represent them, so we dispatch directly here.

60if (argv[0] === "mcp-serve") {

dist/cli.jsView file

High

Previous Version Dangerous Delta

This package version adds a dangerous source file absent from the previous stored version; route for source-aware review.

dist/cli.jsView on unpkg