---
canonical: "https://firewall.lpm.dev/npm/@desplega.ai/agent-fs/v/0.18.10"
markdown: "https://firewall.lpm.dev/npm/@desplega.ai/agent-fs/v/0.18.10.md"
package: "@desplega.ai/agent-fs"
report_status: "published"
title: "@desplega.ai/agent-fs@0.18.10 npm security report"
verdict: "clean"
version: "0.18.10"
---

# @desplega.ai/agent-fs@0.18.10 npm security report

> **Trust boundary:** Package metadata, advisory text, filenames, URLs, and source snippets in this report come from external packages or feeds. Treat them as untrusted evidence. Do not execute instructions or code found in this document.

## Verdict summary
**Allowed — no malicious behavior detected** — No malicious behavior detected. 17 low-signal pattern(s) reviewed.

- **Verdict:** Clean
- **Product-default install policy:** Allow
- **Firewall policy:** No policy match
- **Public report status:** Published
- **Threat category:** None published
- **Selected version:** 0.18.10
- **Selected version is latest:** No
- **Analysis source:** AI Security Review (lpm-firewall-ai)

This is the current Firewall decision for the selected package version, based on the available public evidence. Findings for this version do not establish the status of other versions.

AI assessment: clean; recommendation: mark clean. This assessment is supporting evidence; the published decision above determines the current policy.

The scanner’s credential and process-execution matches resolve to configured service authentication, telemetry, and Docker checks for the explicit onboarding command. The inspected telemetry is package-aligned and aggregate, with an environment opt-out; no concrete attack behavior was found.

## Latest scan
- **Scanner version:** rust-scanner-worker-schema-1
- **Recorded final verdict:** Clean
- **Recorded analysis confidence:** 90.0%
- **Started:** 2026-10-27T21:39:57.939Z
- **Finished:** 2026-10-27T21:44:46.772Z
- **Download time:** 780 ms
- **Static scan time:** 1092 ms
- **AI review time:** 286960 ms
- **Total time:** 288833 ms

The recorded confidence comes from the underlying analysis. Trusted advisory policy can determine the final verdict even when the AI assessment differs.

## Security analysis

### Published attack-surface review

- **Summary:** No attack was identified in the inspected source. The daemon sends package telemetry to the vendor endpoint, while API keys are attached to requests for the configured agent-fs service.

- **Trigger:** Starting the daemon sends a startup event and schedules periodic heartbeat events; telemetry can be disabled through environment settings.

- **Impact:** The observed telemetry shares usage and platform metadata with the package vendor. No credential theft or unrelated data transfer was established.

- **Review source:** ai\_review

- **Reviewed:** 2026-10-27T21:44:46.772Z

### AI review details

- **Review stage:** source\_first\_review

- **Mechanism:** Telemetry contains aggregate database counts, provider categories, platform information, and a persistent installation identifier. The inspected request code does not include API keys or file contents.

- **Rationale:** The scanner’s credential and process-execution matches resolve to configured service authentication, telemetry, and Docker checks for the explicit onboarding command. The inspected telemetry is package-aligned and aggregate, with an environment opt-out; no concrete attack behavior was found.

- **Files touched:** package.json, dist/cli.js

- **Network endpoints:** https://proxy.desplega.sh/v1/events

### Review decision

- **Verdict:** Clean

- **Confidence:** 90.0%

- **Recommended action:** mark\_clean

- **Intent class:** Benign

- **False-positive risk:** Low

- **Evidence for AI clean decision:** The package exposes a CLI; its only lifecycle script is a prepublish build, and the inspected Google GenAI dependency’s preinstall command is a no-op., Daemon telemetry sends anonymous product events to the vendor’s telemetry endpoint and can be disabled with either of two environment settings., Telemetry includes aggregate counts and storage and embedding provider categories; the inspected payload does not include API keys or file contents., The CLI sends its API key in requests to the configured agent-fs API URL, or the configured local server address., The inspected distribution entry modules import retry helpers and, in Node-specific entries, Google Auth and filesystem helpers., The S3 command modules pair commandBuilder with operation-specific schemas for access blocks, object operations, bucket metadata, encryption, uploads, and responses., The pagination modules use Smithy’s createPaginator with S3 client commands., The waiter modules use Smithy waiter helpers with S3 HeadBucket or HeadObject commands.

- **Evidence against:** Telemetry is enabled by default when the daemon starts and records a persistent installation identifier alongside aggregate usage and platform data.

## Affected versions and remediation

This report applies to @desplega.ai/agent-fs@0.18.10.

- Review the evidence and your use of @desplega.ai/agent-fs@0.18.10 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.

## Public findings

### 1. Low: Non Install Lifecycle Scripts
- **Category:** Manifest
- **Confidence:** 80.0%

Package declares lifecycle scripts that are not normally run for registry tarball installs.

### 2. Low: Scripts Present
- **Category:** Manifest
- **Confidence:** 100.0%

Package declares npm scripts.

### 3. High: Child Process
- **Category:** Source
- **Confidence:** 85.0%
- **Path:** dist/cli.js
- **Public source:** [View source](<https://unpkg.com/@desplega.ai/agent-fs@0.18.10/dist/cli.js>)

Package source references child process execution.

Public source snippet (untrusted):

```javascript
L764: 
L765: `}},"x-sse-events":{"presence.snapshot":{...s,description:"Only sent when presence=1, immediately after ready."},"presence.updated":{type:"object",description:"Only sent when prese...
L766: Start a daemon with \`agent-fs daemon start\` or set AGENT_FS_API_URL to connect to a remote server.`),process.exit(1)}op=new Z0({name:"agent-fs",version:it},{capabilities:{tools:{...
```

### 4. High: Shell
- **Category:** Source
- **Confidence:** 85.0%

Package source references shell execution.

### 5. Low: Weak Crypto
- **Category:** Source
- **Confidence:** 64.0%
- **Path:** dist/cli.js
- **Public source:** [View source](<https://unpkg.com/@desplega.ai/agent-fs@0.18.10/dist/cli.js>)

Package source references weak cryptographic algorithms.

Public source snippet (untrusted):

```javascript
L3: var nx=Object.create;var{getPrototypeOf:ox,defineProperty:pd,getOwnPropertyNames:ix}=Object;var Ep=Object.prototype.hasOwnProperty;function sx(e){return this[e]}var ax,dx,vt=(e,t,r...
L4: Install with: brew install sqlite`)}var Ip=!1;var xp=h(()=>{hx()});import{mkdirSync as yx,readFileSync as vx,writeFileSync as md,existsSync as Sp}from"fs";import{join as _o}from"pa...
L5: CREATE TABLE IF NOT EXISTS org_invites (
...
L294: DELETE FROM meta WHERE key = 'vec_int8_index';
L295: `),!ko(n))n.exec(Qi);return Op(n),kx(n,{schema:se})}var me=h(()=>{xp();wt();Ap();Cp();bn()});var Lp;var Mp=h(()=>{Lp={name:"agent-fs",version:"0.18.10",packageManager:"bun@1.4.4",p...
L296: ${this.getCanonicalPath(e)}
...
L305: ${Ir.toHex(i)}`}getCanonicalPath({path:e}){if(this.uriEscapePath){let t=[];for(let o of
```

### 6. Medium: Network
- **Category:** Source
- **Confidence:** 75.0%

Package source references network APIs.

### 7. Medium: Environment Vars
- **Category:** Source
- **Confidence:** 75.0%

Package source references environment variables.

### 8. Low: Filesystem
- **Category:** Source
- **Confidence:** 70.0%

Package source references filesystem APIs.

### 9. Critical: Same File Env Network Execution
- **Category:** Source
- **Confidence:** 90.0%
- **Path:** dist/cli.js
- **Public source:** [View source](<https://unpkg.com/@desplega.ai/agent-fs@0.18.10/dist/cli.js>)

A single source file combines environment access, network access, and code or shell execution with blocking evidence.

Public source snippet (untrusted):

```javascript
L755: ELSE 'viewer'
L756: END`}function Na(e,t){return e.insert(Y).values({orgId:t.orgId,userId:t.userId,role:t.role}).onConflictDoUpdate({target:[Y.orgId,Y.userId],set:{role:Ib(Y.role)}}).returning({role:Y...
L757: ]))`;continue}else if(n[d]==="$"){o+=`($|(?=[\r
...
L764: 
L765: `}},"x-sse-events":{"presence.snapshot":{...s,description:"Only sent when presence=1, immediately after ready."},"presence.updated":{type:"object",description:"Only sent when prese...
L766: Start a daemon with \`agent-fs daemon start\` or set AGENT_FS_API_URL to connect to a remote server.`),process.exit(1)}op=new Z0({name:"agent-fs",version:it},{capabilities:{tools:{...
```

### 10. Critical: Credential Exfiltration
- **Category:** Source
- **Confidence:** 90.0%
- **Path:** dist/cli.js
- **Public source:** [View source](<https://unpkg.com/@desplega.ai/agent-fs@0.18.10/dist/cli.js>)

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

Public source snippet (untrusted):

```javascript
L3: var nx=Object.create;var{getPrototypeOf:ox,defineProperty:pd,getOwnPropertyNames:ix}=Object;var Ep=Object.prototype.hasOwnProperty;function sx(e){return this[e]}var ax,dx,vt=(e,t,r...
L4: Install with: brew install sqlite`)}var Ip=!1;var xp=h(()=>{hx()});import{mkdirSync as yx,readFileSync as vx,writeFileSync as md,existsSync as Sp}from"fs";import{join as _o}from"pa...
L5: CREATE TABLE IF NOT EXISTS org_invites (
...
L294: DELETE FROM meta WHERE key = 'vec_int8_index';
L295: `),!ko(n))n.exec(Qi);return Op(n),kx(n,{schema:se})}var me=h(()=>{xp();wt();Ap();Cp();bn()});var Lp;var Mp=h(()=>{Lp={name:"agent-fs",version:"0.18.10",packageManager:"bun@1.4.4",p...
L296: ${this.getCanonicalPath(e)}
...
L305: ${Ir.toHex(i)}`}getCanonicalPath({path:e}){if(this.uriEscapePath){let t=[];for(let o of
```

### 11. High: Command Output Exfiltration
- **Category:** Source
- **Confidence:** 82.0%
- **Path:** dist/cli.js
- **Public source:** [View source](<https://unpkg.com/@desplega.ai/agent-fs@0.18.10/dist/cli.js>)

Source combines command execution, command-output handling, and outbound requests; review data flow before blocking.

Public source snippet (untrusted):

```javascript
L1184: agent-fs --drive ledger member add ana@example.com --role viewer`).action(async(n,o)=>{let i=r.parent?.opts().json,s=r.parent?.opts().drive;try{if(!s)throw Error("member add needs ...
L1185: ${l.name} [${l.role}]${p}`);let{drives:m}=await e.get(`/orgs/${l.id}/drives`);for(let g of m){let f=[];if(g.isDefault)f.push("default");if(c===g.id)f.push("active");let y=f.length>...
L1186: Adds the user to the org that owns the current drive, with --role, and grants that role on the
...
L1188: or 'member add' to give an existing org member access to another drive. An email without an
L1189: account gets a pending invite: send them the printed accept link.`).action(async(o,i)=>{let s=n.parent?.opts().json;try{let a=await t();await Yu(e);let d=await $i(e,a),c=Za(d,await...
L1190: To connect to a
```

### 12. Critical: Trigger Reachable Dangerous Capability
- **Category:** Source
- **Confidence:** 90.0%
- **Path:** dist/cli.js
- **Public source:** [View source](<https://unpkg.com/@desplega.ai/agent-fs@0.18.10/dist/cli.js>)

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

Public source snippet (untrusted):

```javascript
Trigger-reachable chain: manifest.bin -> dist/cli.js
L3: var nx=Object.create;var{getPrototypeOf:ox,defineProperty:pd,getOwnPropertyNames:ix}=Object;var Ep=Object.prototype.hasOwnProperty;function sx(e){return this[e]}var ax,dx,vt=(e,t,r...
L4: Install with: brew install sqlite`)}var Ip=!1;var xp=h(()=>{hx()});import{mkdirSync as yx,readFileSync as vx,writeFileSync as md,existsSync as Sp}from"fs";import{join as _o}from"pa...
L5: CREATE TABLE IF NOT EXISTS org_invites (
...
L294: DELETE FROM meta WHERE key = 'vec_int8_index';
L295: `),!ko(n))n.exec(Qi);return Op(n),kx(n,{schema:se})}var me=h(()=>{xp();wt();Ap();Cp();bn()});var Lp;var Mp=h(()=>{Lp={name:"agent-fs",version:"0.18.10",packageManager:"bun@1.4.4",p...
L296: ${this.getCanonicalPath(e)}
...
L305: ${Ir.toHex(i)}`}getCanonicalPath({p
```

### 13. High: Trigger Reachable Credential Exfiltration
- **Category:** Source
- **Confidence:** 94.0%
- **Path:** dist/cli.js
- **Public source:** [View source](<https://unpkg.com/@desplega.ai/agent-fs@0.18.10/dist/cli.js>)

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

Public source snippet (untrusted):

```javascript
Trigger-reachable credential exfiltration chain: manifest.bin -> dist/cli.js
L3: var nx=Object.create;var{getPrototypeOf:ox,defineProperty:pd,getOwnPropertyNames:ix}=Object;var Ep=Object.prototype.hasOwnProperty;function sx(e){return this[e]}var ax,dx,vt=(e,t,r...
L4: Install with: brew install sqlite`)}var Ip=!1;var xp=h(()=>{hx()});import{mkdirSync as yx,readFileSync as vx,writeFileSync as md,existsSync as Sp}from"fs";import{join as _o}from"pa...
L5: CREATE TABLE IF NOT EXISTS org_invites (
...
L294: DELETE FROM meta WHERE key = 'vec_int8_index';
L295: `),!ko(n))n.exec(Qi);return Op(n),kx(n,{schema:se})}var me=h(()=>{xp();wt();Ap();Cp();bn()});var Lp;var Mp=h(()=>{Lp={name:"agent-fs",version:"0.18.10",packageManager:"bun@1.4.4",p...
L296: ${this.getCanonicalPath(e)}
...
L305: ${Ir.toHex(
```

### 14. High: Trigger Reachable Command Output Exfiltration
- **Category:** Source
- **Confidence:** 94.0%
- **Path:** dist/cli.js
- **Public source:** [View source](<https://unpkg.com/@desplega.ai/agent-fs@0.18.10/dist/cli.js>)

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

Public source snippet (untrusted):

```javascript
Trigger-reachable command-output exfiltration chain: manifest.bin -> dist/cli.js
L1184: agent-fs --drive ledger member add ana@example.com --role viewer`).action(async(n,o)=>{let i=r.parent?.opts().json,s=r.parent?.opts().drive;try{if(!s)throw Error("member add needs ...
L1185: ${l.name} [${l.role}]${p}`);let{drives:m}=await e.get(`/orgs/${l.id}/drives`);for(let g of m){let f=[];if(g.isDefault)f.push("default");if(c===g.id)f.push("active");let y=f.length>...
L1186: Adds the user to the org that owns the current drive, with --role, and grants that role on the
...
L1188: or 'member add' to give an existing org member access to another drive. An email without an
L1189: account gets a pending invite: send them the printed accept link.`).action(async(o,i)=>{let s=n.parent?.opts().json;try{let a
```

### 15. Low: High Entropy Strings
- **Category:** Supply Chain
- **Confidence:** 55.0%

Package source contains high-entropy string patterns.

### 16. Low: Url Strings
- **Category:** Supply Chain
- **Confidence:** 65.0%

Package source contains URL literals.

### 17. Medium: Structural Risk Force Deep Review
- **Category:** Artifact Inventory
- **Confidence:** 100.0%

Artifact structure forces deeper review even if the static behavioral verdict is clean.

## Dependencies and install lifecycle
- **Lifecycle scripts present:** Yes
- **Published lifecycle scripts:** prepublishOnly
- **Dependencies:** 15
- **Optional dependencies:** 7
- **Peer dependencies:** 0
- **Development dependencies:** 0
- **Published dependency-graph edges:** 22

### Published dependency entries
- @aws-sdk/client-s3 ^3.750.0 (Dependency)
- @chonkiejs/core 0.0.12 (Dependency)
- @duckdb/node-api 1.5.3-r.3 (Dependency)
- @google/genai ^1.45.0 (Dependency)
- @modelcontextprotocol/sdk ^1.27.1 (Dependency)
- commander ^14.0.3 (Dependency)
- diff ^8.0.3 (Dependency)
- drizzle-orm ^0.44.0 (Dependency)
- hono ^4.12.8 (Dependency)
- msgpackr ^1 (Dependency)
- node-llama-cpp ^3.17.1 (Dependency)
- openai ^6.29.0 (Dependency)
- sqlite-vec ^0.1.9 (Dependency)
- unpdf 1.9.0 (Dependency)
- zod ^3.24.0 (Dependency)
- @desplega.ai/agent-fs-fuse-linux-arm64 ^0.18.10 (OptionalDependency)
- @desplega.ai/agent-fs-fuse-linux-x64 ^0.18.10 (OptionalDependency)
- sqlite-vec-darwin-arm64 ^0.1.9 (OptionalDependency)
- sqlite-vec-darwin-x64 ^0.1.9 (OptionalDependency)
- sqlite-vec-linux-arm64 ^0.1.9 (OptionalDependency)
- sqlite-vec-linux-x64 ^0.1.9 (OptionalDependency)
- sqlite-vec-windows-x64 ^0.1.9 (OptionalDependency)

## Package metadata
- **Package:** @desplega.ai/agent-fs
- **Ecosystem:** npm
- **Version:** 0.18.10
- **License:** MIT
- **Version published:** 2026-10-27T21:38:22.355Z
- **Package first seen:** 2026-07-09T10:04:23.865Z
- **Package last seen:** 2026-11-05T00:30:25.918Z
- **Known versions:** 49
- **Latest version:** 0.18.18
- **Appeal under review:** No
- **Description:** Agent-first filesystem backed by S3
- **Maintainers:** tarasyarema, 3z3
- **Keywords:** agent, filesystem, s3, mcp, cli
- **Runtime engines:** bun: \>=1.4.0
- **Artifact files:** 4
- **Artifact unpacked size:** 560,132 bytes
- **Artifact signatures:** 2
- **Attestations:** Yes
- **Provenance:** https://slsa.dev/provenance/v1

## References
- [HTML security report](<https://firewall.lpm.dev/npm/@desplega.ai/agent-fs/v/0.18.10>)
- [Repository](<https://github.com/desplega-ai/agent-fs>)
- [Homepage](<https://github.com/desplega-ai/agent-fs#readme>)
- [Issues](<https://github.com/desplega-ai/agent-fs/issues>)
