registry / @crouton-kit/crouter / 0.3.37

@crouton-kit/crouter@0.3.37

crtr — agent runtime with memory, plugins, and marketplaces

AI Security Review

scanned 6d ago · by lpm-firewall-ai

No confirmed malicious attack surface was established. Risky primitives are CLI/web-agent-runtime features that require user invocation or configuration and are aligned with the package purpose.

Static reason

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

Trigger

User runs crtr commands such as sys setup, sys update, search, or surface web serve.

Impact

Package-aligned local automation; no unconsented install-time or import-time compromise confirmed.

Mechanism

agent runtime CLI with optional local web bridge, plugin setup, OAuth, and update commands

Rationale

Static inspection found powerful agent-runtime behavior, but activation is user-invoked/configured and consistent with crouter's advertised CLI, web UI, setup, search, OAuth, and update features. The install hook is inert guidance only, and no source-grounded credential exfiltration, destructive payload, persistence, or AI-agent control hijack was found.

Evidence

package.jsonscripts/postinstall.mjsbin/crtrbin/crouterbin/crtrddist/cli.jsdist/core/auto-update.jsdist/core/bootstrap.jsdist/core/host-exports/export.jsdist/clients/web/server.jsdist/commands/chord.jsdist/commands/search/exa.js~/.crouter/exa.key~/.claude/commands/*.md~/.pi/agent/prompts/*.md~/.pi/agent/settings.json

Network endpoints4

api.exa.aiclaude.ai/oauth/authorizeplatform.claude.com/v1/oauth/tokengithub.com/crouton-labs/crouter-official-marketplace.git

Decision evidence

public snapshot

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

Evidence for block

dist/core/auto-update.js can run user-configured background npm global self-update after CLI invocation.
dist/clients/web/server.js exposes local exec/file/http bridge when user starts web server, but gated by origin/token rules.
dist/core/host-exports/export.js writes generated host command files only on crtr CLI runs when host dirs already exist.

Evidence against

scripts/postinstall.mjs only prints setup guidance and exits; no install-time payload, network, or file writes.
bin/crtr and bin/crouter only import dist/cli.js; bin/crtrd imports daemon CLI.
dist/commands/chord.js dispatches crtr subcommands via spawn/execFile without shell from explicit --run menu input.
dist/core/self-update.js npm install and git update paths are explicit update features, not install/import-time execution.
dist/commands/search/exa.js and dist/core/hearth/model-auth-guest.js use documented Exa/Anthropic endpoints for user-invoked search/OAuth flows.
No credential harvesting or exfiltration path found beyond user-provided API/OAuth credentials used for package-aligned services.

Behavioral surface

Source

ChildProcessCryptoDynamicRequireEnvironmentVarsFilesystemNetworkShellWebSocket

Supply chain

HighEntropyStringsMinifiedObfuscatedUrlStrings

ManifestNo manifest risk signals triggered.

scanned 308 file(s), 3.89 MB of source, external domains: 127.0.0.1, api.anthropic.com, api.exa.ai, claude.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.js7.18 MB file, sampled 256 KB

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

Source & flagged code

10 flagged

package.jsonView file

Lines 16-56json

16 "types": "./dist/index.d.ts"

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 "scripts/postinstall.mjs"

30 ],

31 "scripts": {

32 "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",

33 "build": "rm -rf dist && tsc && cp -R src/builtin-personas dist/builtin-personas && 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",

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

35 "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);\"",

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

High

Install Time Lifecycle Scripts

Package defines install-time lifecycle scripts.

package.jsonView on unpkg · L36

Medium

Ambiguous Install Lifecycle Script

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

package.jsonView on unpkg · L36

37 "hearth:control-plane": "node dist/hearth/control-plane/main.js",

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 "@blaxel/core": "^0.2.94",

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

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

53 "@earendil-works/pi-ai": "0.80.2",

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

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

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

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 = 7528242 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/commands/chord.jsView file

•matchType = previous_version_dangerous_delta matchedPackage = @crouton-kit/crouter@0.3.36 matchedIdentity = npm:QGNyb3V0b24ta2l0L2Nyb3V0ZXI:0.3.36 similarity = 0.883 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.

dist/commands/chord.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 = 7528242 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/commands/chord.jsView file

Critical

Previous Version Dangerous Delta

This package version adds a dangerous source file absent from the previous stored version.

dist/commands/chord.jsView on unpkg

Findings

1 Critical6 High5 Medium7 Low

CriticalPrevious Version Dangerous Deltadist/commands/chord.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 16-56json

16 "types": "./dist/index.d.ts"

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 "scripts/postinstall.mjs"

30 ],

31 "scripts": {

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

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

High

Install Time Lifecycle Scripts

Package defines install-time lifecycle scripts.

package.jsonView on unpkg · L36

Medium

Ambiguous Install Lifecycle Script

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

package.jsonView on unpkg · L36

37 "hearth:control-plane": "node dist/hearth/control-plane/main.js",

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 "@blaxel/core": "^0.2.94",

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

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

53 "@earendil-works/pi-ai": "0.80.2",

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

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

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

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 = 7528242 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/commands/chord.jsView file

Critical

Previous Version Dangerous Delta

This package version adds a dangerous source file absent from the previous stored version.

dist/commands/chord.jsView on unpkg