focalapi-cli@1.0.1

让任意 AI Agent 直接调用 focalapi 创作模型的命令行工具

AI Security Review

scanned 1mo ago · by lpm-firewall-ai

The postinstall hook installs this package's own FocalAPI skills into detected agent skill directories, which is first-party agent extension setup rather than malware. Source shows no DNS exfil, unofficial credential redirect, or other hidden attack chain.

Static reason

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

Trigger

npm install of focalapi-cli when lifecycle scripts run and FOCALAPI_SKIP_POSTINSTALL is unset.

Impact

Agents such as Claude Code or Cursor may load FocalAPI routing skills after restart without a separate connect command.

Mechanism

postinstall spawns the CLI to copy bundled skills into detected agent skill folders

AI rationale

Evidence

package.jsonscripts/postinstall.cjsdist/cli.jsskills/focalapi/SKILL.md.claude/skills.cursor/skills.agents/skills.focalapi-managed-skills.json

Decision evidence

public snapshot

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

Evidence for warning

npm postinstall runs scripts/postinstall.cjs, which spawns dist/cli.js connect install --json unless FOCALAPI_SKIP_POSTINSTALL or CI is set.
connect install copies bundled focalapi-* skills into detected third-party agent skill directories such as .claude/skills and .cursor/skills.
The primary bundled skill tells agents to route creative work through FocalAPI even when the user does not name it.
Install-time writes are local skill drops with a managed-skills manifest; they do not change agent provider settings files.

Evidence against

No DNS lookups, eval, or runtime self-dependency; scanner DNS-exfil and unofficial-gateway labels do not match this source.
Network use is user-invoked CLI traffic to https://api.focalapi.com (and an npm version check); postinstall does not read API keys or call the network.
Skills and connect code are first-party FocalAPI extensions with a skip flag, CI skip, and uninstall that only removes unmodified managed skills.

Behavioral surface

Source

ChildProcessCryptoEnvironmentVars

Source & flagged code

7 flagged

package.jsonView file

Lines 6-46json

6 "bin": {

7 "focalapi": "dist/cli.js"

8 },

9 "files": [

10 "dist",

11 "scripts",

12 "skills",

13 "README.md",

14 "CHANGELOG.md",

15 "LICENSE"

16 ],

17 "engines": {

18 "node": ">=18"

19 },

20 "scripts": {

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

22 "build": "tsup",

23 "test": "vitest run",

24 "test:watch": "vitest",

25 "typecheck": "tsc --noEmit",

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

High

Install Time Lifecycle Scripts

Package defines install-time lifecycle scripts.

package.jsonView on unpkg · L26

Medium

Ambiguous Install Lifecycle Script

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

package.jsonView on unpkg · L26

27 "prepublishOnly": "npm run build && npm test"

28 },

29 "keywords": [

30 "focalapi",

31 "ai",

32 "agent",

33 "cli",

34 "llm",

35 "image-generation",

36 "video-generation"

37 ],

38 "license": "Apache-2.0",

39 "repository": {

40 "type": "git",

41 "url": "git+https://github.com/focalapi/focalapi-cli.git"

42 },

43 "homepage": "https://github.com/focalapi/focalapi-cli#readme",

44 "bugs": {

45 "url": "https://github.com/focalapi/focalapi-cli/issues"

46 },

dist/cli.jsView file

Lines 21-61javascript

21 this.status = opts?.status;

22 this.hint = opts?.hint;

23 this.body = opts?.body;

24 this.upstreamCode = opts?.upstreamCode;

25 this.requestId

Source & flagged code

7 flagged · loading source

package.jsonView file

•scripts.postinstall = node scripts/postinstall.cjs

High

Install Time Lifecycle Scripts

Package defines install-time lifecycle scripts.

package.jsonView on unpkg

•scripts.postinstall = node scripts/postinstall.cjs

Medium

Ambiguous Install Lifecycle Script

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

package.jsonView on unpkg

dist/cli.jsView file

41missing_api_key: "\u672A\u914D\u7F6E API Key\u3002\u8FD0\u884C focalapi auth login --key <sk-...>\uFF0C\u6216\u8BBE\u7F6E\u73AF\u5883\u53D8\u91CF FOCALAPI_API_KEY\u3002", L42: invalid_api_key: "API Key \u65E0\u6548\u3001\u5DF2\u8FC7\u671F\u6216\u88AB\u5220\u9664\u3002\u524D\u5F80 https://focalapi.com/console/token \u68C0\u67E5\u6216\u65B0\u5EFA Key\uFF0C... L43: insufficient_quota: "\u8D26\u6237\u989D\u5EA6\u4E0D\u8DB3\u3002\u524D\u5F80 https://focalapi.com/console/topup \u5145\u503C\uFF1B\u53EF\u8FD0\u884C focalapi usage \u67E5\u770B\u5F5... ... L84: function isInteractive() { L85: return Boolean(process.stdout.isTTY) && !process.env.CI; L86: } ... L115: function printJson(data) { L116: process.stdout.write(JSON.stringify(sanitize(data), null, 2) + "\n"); L117: } ... L199: function c

Findings

2 Critical4 High4 Medium5 Low

CriticalDns Exfiltrationdist/cli.js

CriticalTrigger Reachable Dangerous Capabilitydist/cli.js

HighInstall Time Lifecycle Scriptspackage.json

HighCredential Redirect Persistencedist/cli.js

HighKnown Malware Source Similaritydist/cli.js

HighKnown Malware Source Fingerprint Signaturedist/cli.js

MediumAmbiguous Install Lifecycle Scriptpackage.json

MediumNetwork

MediumEnvironment Vars

MediumStructural Risk Force Deep Review

LowNon Install Lifecycle Scripts

LowScripts Present

LowFilesystem

LowHigh Entropy Strings

Affected versions and remediation

This report applies to focalapi-cli@1.0.1.

See all versions of focalapi-cli for other recorded verdicts.

Review the evidence and your use of focalapi-cli@1.0.1 before allowing it. Restrict the permissions described in this report.
Choose an independently verified alternative or release. This report does not establish that other versions are safe.

Evidence last updated: 2026-09-17 11:19:19.595Z (UTC).

Think this verdict is wrong? Dispute it on GitHub or read how reports are produced.

AI Security Review

Decision evidence

Source & flagged code

Source & flagged code

Findings

Affected versions and remediation

Runtime surface

Behavioral surface

Source & flagged code