@factiii/runner@0.12.0

Factiii Runner, run Board AI agents on a machine you control. Pairs with the Factiii web/mobile clients over WebRTC.

AI Security Review

scanned 1mo ago · by lpm-firewall-ai

The source establishes a real, user-scoped agent extension and update capability, requiring a warning. It lacks an npm registry install lifecycle hook and the inspected hooks are constrained to the runner context, so the source does not establish malicious install-hook abuse.

Static reason

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

Trigger

A user runs the runner setup/start workflow and provisions a Factiii space; a paired client can request an update.

Impact

It can affect future Claude and Codex sessions for that user and replace the globally installed runner release.

Mechanism

User-scoped agent extension and MCP registration with remotely triggered global update.

AI rationale

Evidence

dist/cli.jsplugin/factiii/hooks/hooks.jsonplugin/factiii/bin/report-state.sh.factiii-runner/plugin

Network endpoints1

api.factiii.com

Decision evidence

public snapshot

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

Evidence for warning

The runner installs and updates a Factiii plugin in both Claude and Codex user scopes.
It registers user-scoped MCP endpoints and bearer-token configuration for both agent CLIs.
The bundled plugin executes status-reporting hooks on agent lifecycle events.
A remotely approved update can globally install the latest package release and restart the runner.

Evidence against

package.json has no npm install, preinstall, or postinstall hook; prepublishOnly is publish-time only.
The behavior is reached through the explicit runner setup/start workflow, not package installation.
The hook script exits unless it finds the runner's tmux pane and local Redis socket.

Behavioral surface

Source

ChildProcessCryptoEnvironmentVarsEvalFilesystemNetwork

Supply chain

HighEntropyStringsUrlStrings

Manifest

WildcardDependency

Source & flagged code

14 flagged

dist/cli.jsView file

38* Constructs the CommanderError class L39: * @param {number} exitCode suggested exit code which could be used with process.exit L40: * @param {string} code an id string representing the error ... L964: var EventEmitter = require("node:events").EventEmitter; L965: var childProcess = require("node:child_process"); L966: var path23 = require("node:path"); ... L1013: this._outputConfiguration = { L1014: writeOut: (str) => process2.stdout.write(str), L1015: writeErr: (str) => process2.stderr.write(str), ... L1049: * @returns {Command[]} L1050: * @private L1051: */

Critical

Credential Exfiltration

Source appears to send environment or credential material to an external endpoint.

dist/cli.jsView on unpkg · L38

38Trigger-reachable chain: scripts.start -> dist/cli.js L38: * Constructs the CommanderError class L39: * @param {number} exitCode suggested exit code which could be used with process.exit L40: * @param {string} code an id string representing the error ... L964: var EventEmitter = require("node:events").EventEmitter; L965: var childProcess = require("node:child_process"); L966: var path23 = require("node:path"); ... L1013: this._outputConfiguration = { L1014: writeOut: (str) => process2.stdout.write(str), L1015: writeErr: (str) => process2.stderr.write(str), ... L1049: * @returns {Command[]} L1050: * @private L1051: */

Critical

Trigger Reachable Dangerous Capability

A package entrypoint or install-time lifecycle script reaches a source file with blocking dangerous behavior.

dist/cli.jsView on unpkg · L38

964var EventEmitter = require("node:events").EventEmitter; L965: var childProcess = require("node:child_process"); L966: var path23 = require("node:path");

High

Child Process

Package source references child process execution.

dist/cli.jsView on unpkg · L964

17636var SELF_WRITE_MS = 2e3; L17637: var dynamicImport = new Function("s", "return import(s)"); L17638: var importFs = new Function("s", "return import(s)");

High

Eval

Package source references dynamic code evaluation.

dist/cli.jsView on unpkg · L17636

•Manifest-reachable source captures an API credential, sends it to a fixed unofficial gateway, and persists that redirection in agent or shell configuration. dist/cli.js: headers["Authorization"] = "Basic " + authBuf.toString("base64"); fs15.writeFileSync(syncFile, "", "utf8"); var execString = "var http = require('http'), https = require('https'), fs = require('fs');var doRequest = http" + (ssl ? "s" : "") + ".request;var options = " + JSON.stringify(opt... delete opts.headers.authorization; if (opts.auth && !options.headers.authorization) { options.headers.authorization = "Basic " + Buffer.from(opts.auth).toString("base64"); content: `Claude ${e.claude_code_version ?? ""} (${e.model ?? "unknown"})` "- Persistent agent memory in your state dir (~/.claude or ~/.codex) that survives across s

High

Credential Redirect Persistence

Manifest-reachable source sends a prompted API credential to a fixed unofficial gateway and persists the redirection.

dist/cli.jsView on unpkg

38Cross-file remote execution chain: dist/cli.js spawns index/index.js; helper contains network access plus dynamic code execution. L38: * Constructs the CommanderError class L39: * @param {number} exitCode suggested exit code which could be used with process.exit L40: * @param {string} code an id string representing the error ... L964: var EventEmitter = require("node:events").EventEmitter; L965: var childProcess = require("node:child_process"); L966: var path23 = require("node:path"); ... L1013: this._outputConfiguration = { L1014: writeOut: (str) => process2.stdout.write(str), L1015: writeErr: (str) => process2.stderr.write(str), ... L1049: * @returns {Command[]} L1050: * @private L1051: */

High

Cross File Remote Execution Context

Source spawns a local helper that also contains network and dynamic execution context; review data flow before blocking.

dist/cli.jsView on unpkg · L38

38Trigger-reachable credential exfiltration chain: scripts.start -> dist/cli.js L38: * Constructs the CommanderError class L39: * @param {number} exitCode suggested exit code which could be used with process.exit L40: * @param {string} code an id string representing the error ... L964: var EventEmitter = require("node:events").EventEmitter; L965: var childProcess = require("node:child_process"); L966: var path23 = require("node:path"); ... L1013: this._outputConfiguration = { L1014: writeOut: (str) => process2.stdout.write(str), L1015: writeErr: (str) => process2.stderr.write(str), ... L1049: * @returns {Command[]} L1050: * @private L1051: */

High

Trigger Reachable Credential Exfiltration

A manifest entrypoint or package-local install chain reaches credential exfiltration behavior.

dist/cli.jsView on unpkg · L38

12948patternName = generic_password severity = medium line = 12948

Medium

Secret Pattern

Package contains a possible secret pattern.

dist/cli.jsView on unpkg · L12948

Low

Weak Crypto

Package source references weak cryptographic algorithms.

dist/cli.jsView on unpkg · L38

index/index.jsView file

41664if (e) return e.href; L41665: F(`Invalid absolute docBaseUrl: "${t}".`); L41666: } ... L87787: * L87788: * This can be used by clients to improve the LLM's understanding of available tools, resources, etc. It can be thought of like a "hint" to the model. For example, this information ... L87789: */

High

Remote Agent Bridge

Source exposes local file and command tools to a remote model endpoint.

index/index.jsView on unpkg · L41664

•stage = ast_semantic_analysis; reason = ast_path_work_budget_exceeded; limitedFiles = 2

High

Semantic Analysis Limited

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

index/index.jsView on unpkg

vendor/frpc-linux-amd64View file

•path = vendor/frpc-linux-amd64 kind = native_binary sizeBytes = 16453816 magicHex = [redacted]

Medium

Ships Native Binary

Package ships native binary artifacts.

vendor/frpc-linux-amd64View on unpkg

plugin/factiii/bin/report-state.shView file

•path = plugin/factiii/bin/report-state.sh kind = build_helper sizeBytes = 1931 magicHex = [redacted]

Medium

Ships Build Helper

Package ships non-JavaScript build or shell helper files.

plugin/factiii/bin/report-state.shView on unpkg

vendor/tmux-resurrect/scripts/save.shView file

•matchType = normalized_sha256 matchedPackage = @ayorcodes/claudespace@0.9.0 matchedPath = libexec/claudespace.dist/claudespace/assets/tmux-plugins/resurrect/scripts/save.sh matchedIdentity = npm:QGF5b3Jjb2Rlcy9jbGF1ZGVzcGFjZQ:0.9.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.

vendor/tmux-resurrect/scripts/save.shView on unpkg

Source & flagged code

14 flagged · loading source

dist/cli.jsView file

Critical

Credential Exfiltration

Source appears to send environment or credential material to an external endpoint.

dist/cli.jsView on unpkg · L38

Critical

Trigger Reachable Dangerous Capability

A package entrypoint or install-time lifecycle script reaches a source file with blocking dangerous behavior.

dist/cli.jsView on unpkg · L38

Findings

2 Critical8 High7 Medium6 Low

CriticalCredential Exfiltrationdist/cli.js

CriticalTrigger Reachable Dangerous Capabilitydist/cli.js

HighChild Processdist/cli.js

HighEvaldist/cli.js

HighCredential Redirect Persistencedist/cli.js

HighRemote Agent Bridgeindex/index.js

HighCross File Remote Execution Contextdist/cli.js

HighTrigger Reachable Credential Exfiltrationdist/cli.js

HighSemantic Analysis Limitedindex/index.js

HighKnown Malware Source Similarityvendor/tmux-resurrect/scripts/save.sh

MediumSecret Patterndist/cli.js

MediumNetwork

Affected versions and remediation

This report applies to @factiii/runner@0.12.0.

See all versions of @factiii/runner for other recorded verdicts.

Review the evidence and your use of @factiii/runner@0.12.0 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-16 04:16:14.802Z (UTC).

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