registry / @crouton-kit/crouter / 0.3.44

@crouton-kit/crouter@0.3.44

crtr — agent runtime with memory, plugins, and marketplaces

AI Security Review

scanned 4d ago · by lpm-firewall-ai

No confirmed malicious attack surface was established. The package is an agent runtime with user-invoked setup, marketplace, web bridge, and update features, but install-time behavior is inert guidance only.

Static reason

One or more suspicious static signals were detected.; previous stored version diff introduced dangerous source

Trigger

User runs crtr CLI commands such as first-run bootstrap, sys/update, surface web serve, or host export provisioning.

Impact

Can create ~/.crouter state, clone an official marketplace, write marker-guarded host command templates, and run local bridge requests when explicitly served by the user.

Mechanism

package-aligned agent runtime setup and local control bridge

Rationale

The suspicious primitives are real but are user-invoked, documented, and aligned with an agent runtime; the npm lifecycle hook does not plant agent controls or execute setup. I found no concrete unconsented install-time mutation, exfiltration, destructive persistence, or hidden payload.

Evidence

package.jsonscripts/postinstall.mjsREADME.mddist/cli.jsdist/core/bootstrap.jsdist/core/host-exports/export.jsdist/core/auto-update.jsdist/core/self-update.jsdist/clients/web/server.jsdist/core/view/transport-local.js~/.crouter/config.json~/.crouter/state.json~/.crouter/marketplaces/crouter-official-marketplace~/.claude/commands/*.md~/.pi/agent/prompts/*.md

Network endpoints1

github.com/crouton-labs/crouter-official-marketplace.git

Decision evidence

public snapshot

AI called this Clean at 86.0% confidence as Benign with low false-positive risk.

Evidence for block

dist/core/host-exports/export.js can write marker-bearing slash commands into existing ~/.claude/commands and ~/.pi/agent/prompts on CLI runs
dist/clients/web/server.js exposes a user-invoked local bridge that can run exec/file/http SourceRequests
dist/core/bootstrap.js clones the official marketplace on first non-help CLI run

Evidence against

scripts/postinstall.mjs only prints setup guidance and exits; no install-time file/control-surface mutation
Host command exports are skipped for help/bare boot, require existing host roots, and avoid clobbering markerless user files
Web server binds 127.0.0.1 by default and requires --token for non-loopback hosts
Agent/runtime, marketplace bootstrap, self-update, and web bridge behavior are package-aligned and documented in README/help
No credential harvesting, destructive persistence, hidden exfiltration, obfuscated payload, or remote code execution during install/import found

Behavioral surface

Source

ChildProcessCryptoDynamicRequireEnvironmentVarsFilesystemNetworkShellWebSocket

Supply chain

HighEntropyStringsMinifiedObfuscatedUrlStrings

ManifestNo manifest risk signals triggered.

scanned 289 file(s), 3.83 MB of source, external domains: 127.0.0.1, api.anthropic.com, api.exa.ai, dashboard.exa.ai, docs.expo.dev, github.com, mail.google.com, platform.claude.com, pure.md, react.dev, reactrouter.com, www.linkedin.com, www.w3.org

Oversized source lightweight scan

dist/clients/attach/attach-cmd.js6.97 MB file, sampled 256 KB

FilesystemChildProcessEnvironmentVarsDynamicRequireObfuscatedHighEntropyStringsMinifiedUrlStringsapi.anthropic.comdocs.expo.devgithub.complatform.claude.com

Source & flagged code

10 flagged

package.jsonView file

Lines 17-57json

17 },

18 "./cli": {

19 "import": "./dist/cli.js"

20 },

21 "./web": {

22 "import": "./dist/web/index.js",

23 "types": "./dist/web/index.d.ts"

24 }

25 },

26 "files": [

27 "dist",

28 "bin",

29 "docs",

30 "scripts/postinstall.mjs"

31 ],

32 "scripts": {

33 "prebuild": "rm -rf node_modules/@earendil-works/pi-coding-agent/node_modules/@earendil-works/pi-tui node_modules/@earendil-works/pi-coding-agent/node_modules/@earendil-works/pi-ai node_modules/@earendil-works/pi-coding-agent/node_modules/@earendil-works/pi-agent-core",

34 "build": "rm -rf dist && tsc && cp -R src/builtin-views dist/builtin-views && cp -R src/builtin-memory dist/builtin-memory && cp -R src/builtin-pi-packages dist/builtin-pi-packages && npm run build:attach && vite build --config src/clients/web/web-client/vite.config.ts",

35 "lint:web-px": "node scripts/lint-web-px.mjs",

36 "build:attach": "esbuild src/clients/attach/attach-cmd.ts --bundle --minify --format=esm --platform=node --target=node22 --alias:@earendil-works/pi-tui=$PWD/node_modules/@earendil-works/pi-tui --outfile=dist/clients/attach/attach-cmd.js --log-level=warning --banner:js=\"import{createRequire as __cr}from'node:module';const require=__cr(import.meta.url);\"",

37 "postinstall": "node scripts/postinstall.mjs",

High

Install Time Lifecycle Scripts

Package defines install-time lifecycle scripts.

package.jsonView on unpkg · L37

Medium

Ambiguous Install Lifecycle Script

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

package.jsonView on unpkg · L37

38 "dev": "tsx src/cli.ts",

39 "link": "npm link",

40 "prepublishOnly": "npm run build",

41 "test": "node --import tsx/esm --test 'src/**/__tests__/*.test.ts'",

42 "test:full": "node --import tsx/esm --test-concurrency=4 --test 'src/**/__tests__/**/*.test.ts'"

43 },

44 "repository": {

45 "type": "git",

46 "url": "git+https://github.com/crouton-labs/crouter.git"

47 },

48 "license": "MIT",

49 "dependencies": {

50 "@crouton-kit/humanloop": "^0.3.20",

51 "@earendil-works/pi-agent-core": "0.80.2",

52 "@earendil-works/pi-ai": "0.80.3",

53 "@earendil-works/pi-coding-agent": "0.80.2",

54 "@earendil-works/pi-tui": "0.80.2",

55 "@fontsource-variable/fraunces": "^5.2.9",

56 "@fontsource-variable/instrument-sans": "^5.2.8",

57 "@fontsource-variable/martian-mono": "^5.2.7",

dist/clients/web/web-cmd.jsView file

Lines 1-32javascript

1// web-cmd.ts — the `crtr surface web` command leaf + registration.

2//

3// Starts the ONE long-running unified web server (server.ts): the crouter web UI

4// host. It serves the shell SPA, the source + command bridge (POST

5// /__crtr/source), the SSE change lane (GET /__crtr/events), and a VERBATIM

6// browser ⇄ broker relay on `ws://HOST:PORT/node/<id>` (the browser becomes

7// the SAME protocol peer as surface attach). The node is selected by the URL, so

8// there is NO positional node here.

9//

10// Command shape (plan §3.6): the CLI path-walker forbids a flat top-level leaf

11// (`defineRoot.subtrees` is `BranchDef[]`), so `web` is a BRANCH wrapping a

dist/clients/attach/slash-commands.jsView file

Lines 342-382javascript

342 return true;

343}

344/** `/context`. Opens `crtr node inspect context` as a popup — a

345 * read-only nvim explorer over this node's + its subscriptions' context dirs.

346 * Self-contained popup — no node-focus, no return-pane. */

347function openContext(ctx) {

348 if (process.env['TMUX'] === undefined

dist/clients/attach/config-load.jsView file

Lines 104-144javascript

104 setKeybindings(km);

105 return km;

106}

107/**

108 * pi-coding-agent's `CustomEditor` resolves `@earendil-works/pi-tui` from its OWN

109 * `node_modules`, which can be a SEPARATE module instance from the one this file

110 * imports (a non-deduped install leaves a nested copy). The editor's newline /

111 * submit handling reads keybindings AND the kitty-protocol flag from THAT

112 * instance's module-globals via `getKeybindings()` / `isKittyProtocolActive()`,

113 * so state we set only on our copy is invisible to it — the user's `alt+enter`

dist/builtin-pi-packages/pi-crtr-extensions/extensions/crouter-help.tsView file

Lines 1-21typescript

1import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";

2import { execFile } from "node:child_process";

3import { promisify } from "node:util";

Low

Weak Crypto

Package source references weak cryptographic algorithms.

dist/builtin-pi-packages/pi-crtr-extensions/extensions/crouter-help.tsView on unpkg · L1

4import

dist/core/self-update.jsView file

Lines 3-43javascript

3// (core) previously imported from commands/update.ts (commands layer).

4import { spawnSync } from 'node:child_process';

5import { fileURLToPath } from 'node:url';

6import { join, dirname } from 'node:path';

7import { readFileSync } from 'node:fs';

8import { listAllPlugins, listAllMarketplaces } from

dist/web-client/assets/martian-mono-latin-wght-normal-5W32yIyr.woff2View file

•path = dist/web-client/assets/martian-mono-latin-wght-normal-5W32yIyr.woff2 kind = high_entropy_blob sizeBytes = 23556 magicHex = [redacted]

High

Ships High Entropy Blob

Package ships high-entropy non-source blobs.

dist/web-client/assets/martian-mono-latin-wght-normal-5W32yIyr.woff2View on unpkg

dist/clients/attach/attach-cmd.jsView file

•path = dist/clients/attach/attach-cmd.js kind = oversized_source_file sizeBytes = 7307122 magicHex = [redacted]

High

Oversized Source File

Package contains source files above the static scanner size ceiling.

dist/clients/attach/attach-cmd.jsView on unpkg

dist/core/runtime/broker.jsView file

•matchType = previous_version_dangerous_delta matchedPackage = @crouton-kit/crouter@0.3.40 matchedIdentity = npm:QGNyb3V0b24ta2l0L2Nyb3V0ZXI:0.3.40 similarity = 0.708 summary = stored previous version shares package body but lacks this dangerous source file

Critical

Previous Version Dangerous Delta

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

dist/core/runtime/broker.jsView on unpkg

Source & flagged code

10 flagged · loading source

package.jsonView file

•scripts.postinstall = node scripts/postinstall.mjs

High

Install Time Lifecycle Scripts

Package defines install-time lifecycle scripts.

package.jsonView on unpkg

•scripts.postinstall = node scripts/postinstall.mjs

Medium

Ambiguous Install Lifecycle Script

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

package.jsonView on unpkg

dist/clients/web/web-cmd.jsView file

12// single leaf: `crtr surface web serve`. L13: import { spawn } from 'node:child_process'; L14: import { defineBranch, defineLeaf } from '../../core/command.js';

High

Child Process

Package source references child process execution.

dist/clients/web/web-cmd.jsView on unpkg · L12

dist/clients/attach/slash-commands.jsView file

362/** Open `cmd` as a fire-and-forget tmux display-popup (same geometry as the canvas L363: * extensions). tmux runs the trailing string through `sh -c`; the popup owns its L364: * screen and closes itself when the command exits, dropping back to this pane. */

High

Shell

Package source references shell execution.

dist/clients/attach/slash-commands.jsView on unpkg · L362

dist/clients/attach/config-load.jsView file

124const pcaEntry = import.meta.resolve('@earendil-works/pi-coding-agent'); L125: const piTuiPath = createRequire(pcaEntry).resolve('@earendil-works/pi-tui'); L126: return (await import(pathToFileURL(piTuiPath).href));

Medium

Dynamic Require

Package source references dynamic require/import behavior.

dist/clients/attach/config-load.jsView on unpkg · L124

dist/builtin-pi-packages/pi-crtr-extensions/extensions/crouter-help.tsView file

1import type { ExtensionAPI } from "@earendil-works/pi-coding-agent"; L2: import { execFile } from "node:child_process"; L3: import { promisify } from "node:util"; ... L25: const h = createHash("sha1").update(cwd).digest("hex").slice(0, 16); L26: return join(homedir(), ".crouter", "cache", `crouter-help-${h}.json`); L27: } ... L38: try { L39: const c = JSON.parse(readFileSync(file, "utf8")) as { text?: string; at?: number }; L40: if (typeof c.text === "string" && c.text && typeof c.at === "number" && Date.now() - c.at < TTL_MS) { ... L49: try { L50: const { stdout } = await run("crouter", ["-h"], { timeout: 10_000 }); L51: helpText = stdout.trim();

Low

Weak Crypto

Package source references weak cryptographic algorithms.

dist/builtin-pi-packages/pi-crtr-extensions/extensions/crouter-help.tsView on unpkg · L1

dist/core/self-update.jsView file

23export function selfUpdate() { L24: const res = spawnSync('npm', ['i', '-g', '@crouton-kit/crouter@latest'], { stdio: 'inherit' }); L25: if (res.status !== 0) { L26: throw general('npm install failed'); L27: }

High

Runtime Package Install

Package source invokes a package manager install command at runtime.

dist/core/self-update.jsView on unpkg · L23

dist/web-client/assets/martian-mono-latin-wght-normal-5W32yIyr.woff2View file

•path = dist/web-client/assets/martian-mono-latin-wght-normal-5W32yIyr.woff2 kind = high_entropy_blob sizeBytes = 23556 magicHex = [redacted]

High

Ships High Entropy Blob

Package ships high-entropy non-source blobs.

dist/web-client/assets/martian-mono-latin-wght-normal-5W32yIyr.woff2View on unpkg

dist/clients/attach/attach-cmd.jsView file

•path = dist/clients/attach/attach-cmd.js kind = oversized_source_file sizeBytes = 7307122 magicHex = [redacted]

High

Oversized Source File

Package contains source files above the static scanner size ceiling.

dist/clients/attach/attach-cmd.jsView on unpkg

dist/core/runtime/broker.jsView file

Critical

Previous Version Dangerous Delta

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

dist/core/runtime/broker.jsView on unpkg

Findings

1 Critical6 High5 Medium7 Low

CriticalPrevious Version Dangerous Deltadist/core/runtime/broker.js

HighInstall Time Lifecycle Scriptspackage.json

HighChild Processdist/clients/web/web-cmd.js

HighShelldist/clients/attach/slash-commands.js

HighRuntime Package Installdist/core/self-update.js

HighShips High Entropy Blobdist/web-client/assets/martian-mono-latin-wght-normal-5W32yIyr.woff2

HighOversized Source Filedist/clients/attach/attach-cmd.js

MediumAmbiguous Install Lifecycle Scriptpackage.json

MediumDynamic Requiredist/clients/attach/config-load.js

MediumNetwork

MediumEnvironment Vars

MediumStructural Risk Force Deep Review

LowNon Install Lifecycle Scripts

LowScripts Present

LowWeak Cryptodist/builtin-pi-packages/pi-crtr-extensions/extensions/crouter-help.ts

LowFilesystem

LowObfuscated

LowHigh Entropy Strings

LowUrl Strings

Source & flagged code

10 flagged

package.jsonView file

Lines 17-57json

17 },

18 "./cli": {

19 "import": "./dist/cli.js"

20 },

21 "./web": {

22 "import": "./dist/web/index.js",

23 "types": "./dist/web/index.d.ts"

24 }

25 },

26 "files": [

27 "dist",

28 "bin",

29 "docs",

30 "scripts/postinstall.mjs"

31 ],

32 "scripts": {

35 "lint:web-px": "node scripts/lint-web-px.mjs",

37 "postinstall": "node scripts/postinstall.mjs",

High

Install Time Lifecycle Scripts

Package defines install-time lifecycle scripts.

package.jsonView on unpkg · L37

Medium

Ambiguous Install Lifecycle Script

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

package.jsonView on unpkg · L37

38 "dev": "tsx src/cli.ts",

39 "link": "npm link",

40 "prepublishOnly": "npm run build",

41 "test": "node --import tsx/esm --test 'src/**/__tests__/*.test.ts'",

42 "test:full": "node --import tsx/esm --test-concurrency=4 --test 'src/**/__tests__/**/*.test.ts'"

43 },

44 "repository": {

45 "type": "git",

46 "url": "git+https://github.com/crouton-labs/crouter.git"

47 },

48 "license": "MIT",

49 "dependencies": {

50 "@crouton-kit/humanloop": "^0.3.20",

51 "@earendil-works/pi-agent-core": "0.80.2",

52 "@earendil-works/pi-ai": "0.80.3",

53 "@earendil-works/pi-coding-agent": "0.80.2",

54 "@earendil-works/pi-tui": "0.80.2",

55 "@fontsource-variable/fraunces": "^5.2.9",

56 "@fontsource-variable/instrument-sans": "^5.2.8",

57 "@fontsource-variable/martian-mono": "^5.2.7",

dist/clients/web/web-cmd.jsView file

Lines 1-32javascript

1// web-cmd.ts — the `crtr surface web` command leaf + registration.

2//

3// Starts the ONE long-running unified web server (server.ts): the crouter web UI

4// host. It serves the shell SPA, the source + command bridge (POST

5// /__crtr/source), the SSE change lane (GET /__crtr/events), and a VERBATIM

6// browser ⇄ broker relay on `ws://HOST:PORT/node/<id>` (the browser becomes

7// the SAME protocol peer as surface attach). The node is selected by the URL, so

8// there is NO positional node here.

9//

10// Command shape (plan §3.6): the CLI path-walker forbids a flat top-level leaf

11// (`defineRoot.subtrees` is `BranchDef[]`), so `web` is a BRANCH wrapping a

dist/clients/attach/slash-commands.jsView file

Lines 342-382javascript

342 return true;

343}

344/** `/context`. Opens `crtr node inspect context` as a popup — a

345 * read-only nvim explorer over this node's + its subscriptions' context dirs.

346 * Self-contained popup — no node-focus, no return-pane. */

347function openContext(ctx) {

348 if (process.env['TMUX'] === undefined

dist/clients/attach/config-load.jsView file

Lines 104-144javascript

104 setKeybindings(km);

105 return km;

106}

107/**

108 * pi-coding-agent's `CustomEditor` resolves `@earendil-works/pi-tui` from its OWN

109 * `node_modules`, which can be a SEPARATE module instance from the one this file

110 * imports (a non-deduped install leaves a nested copy). The editor's newline /

111 * submit handling reads keybindings AND the kitty-protocol flag from THAT

112 * instance's module-globals via `getKeybindings()` / `isKittyProtocolActive()`,

113 * so state we set only on our copy is invisible to it — the user's `alt+enter`

dist/builtin-pi-packages/pi-crtr-extensions/extensions/crouter-help.tsView file

Lines 1-21typescript

1import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";

2import { execFile } from "node:child_process";

3import { promisify } from "node:util";

Low

Weak Crypto

Package source references weak cryptographic algorithms.

dist/builtin-pi-packages/pi-crtr-extensions/extensions/crouter-help.tsView on unpkg · L1

4import

dist/core/self-update.jsView file

Lines 3-43javascript

3// (core) previously imported from commands/update.ts (commands layer).

4import { spawnSync } from 'node:child_process';

5import { fileURLToPath } from 'node:url';

6import { join, dirname } from 'node:path';

7import { readFileSync } from 'node:fs';

8import { listAllPlugins, listAllMarketplaces } from

dist/web-client/assets/martian-mono-latin-wght-normal-5W32yIyr.woff2View file

•path = dist/web-client/assets/martian-mono-latin-wght-normal-5W32yIyr.woff2 kind = high_entropy_blob sizeBytes = 23556 magicHex = [redacted]

High

Ships High Entropy Blob

Package ships high-entropy non-source blobs.

dist/web-client/assets/martian-mono-latin-wght-normal-5W32yIyr.woff2View on unpkg

dist/clients/attach/attach-cmd.jsView file

•path = dist/clients/attach/attach-cmd.js kind = oversized_source_file sizeBytes = 7307122 magicHex = [redacted]

High

Oversized Source File

Package contains source files above the static scanner size ceiling.

dist/clients/attach/attach-cmd.jsView on unpkg

dist/core/runtime/broker.jsView file

Critical

Previous Version Dangerous Delta

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

dist/core/runtime/broker.jsView on unpkg