@parall/daemon 1.29.2 → 1.30.0

package/dist/filesystem.d.ts

@@ -0,0 +1,7 @@
+import type { FilesystemEntry } from "@parall/sdk";
+export declare function browseDenyReason(value: string): string;
+export declare function listDirectory(dirPath: string): Promise<{
+    entries: FilesystemEntry[];
+    error?: string;
+}>;
+//# sourceMappingURL=filesystem.d.ts.map

package/dist/filesystem.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"filesystem.d.ts","sourceRoot":"","sources":["../src/filesystem.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAqCnD,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAkBtD;AAoBD,wBAAsB,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC;IAAE,OAAO,EAAE,eAAe,EAAE,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CA8C5G"}

package/dist/filesystem.js

@@ -0,0 +1,118 @@
+import * as fs from "fs";
+import * as path from "path";
+import * as os from "os";
+const MAX_ENTRIES = 200;
+const SYSTEM_DIR_PREFIXES = [
+    "/Applications",
+    "/bin",
+    "/boot",
+    "/dev",
+    "/etc",
+    "/Library",
+    "/private",
+    "/proc",
+    "/root",
+    "/run",
+    "/sbin",
+    "/System",
+    "/sys",
+    "/usr",
+    "/var",
+];
+const CREDENTIAL_DIR_NAMES = new Set([
+    ".aws",
+    ".azure",
+    ".claude",
+    ".codex",
+    ".config",
+    ".docker",
+    ".gnupg",
+    ".kube",
+    ".npm",
+    ".ssh",
+    ".parall-agent",
+    ".parall-daemon",
+]);
+export function browseDenyReason(value) {
+    const normalized = path.resolve(value).split(path.sep).join("/");
+    if (normalized === "/")
+        return "";
+    for (const prefix of SYSTEM_DIR_PREFIXES) {
+        if (normalized === prefix || normalized.startsWith(`${prefix}/`)) {
+            return "a system directory";
+        }
+    }
+    const parts = normalized.split("/").filter(Boolean);
+    for (const part of parts) {
+        if (CREDENTIAL_DIR_NAMES.has(part)) {
+            return "a credential or application state directory";
+        }
+    }
+    return "";
+}
+function syntheticRoots() {
+    const roots = [];
+    const platform = os.platform();
+    const candidates = platform === "darwin"
+        ? ["/Users", os.homedir()]
+        : ["/home", os.homedir()];
+    for (const dir of [...new Set(candidates)]) {
+        try {
+            fs.accessSync(dir, fs.constants.R_OK);
+            roots.push({ name: dir, type: "dir" });
+        }
+        catch {
+            // not accessible
+        }
+    }
+    return roots;
+}
+export async function listDirectory(dirPath) {
+    const resolved = path.resolve(dirPath);
+    const normalized = resolved.split(path.sep).join("/");
+    if (normalized === "/") {
+        return { entries: syntheticRoots() };
+    }
+    const deny = browseDenyReason(normalized);
+    if (deny) {
+        return { entries: [], error: `Access denied: ${deny}` };
+    }
+    let realPath;
+    try {
+        realPath = fs.realpathSync(resolved);
+    }
+    catch (err) {
+        const code = err.code;
+        if (code === "ENOENT")
+            return { entries: [], error: "Directory not found" };
+        return { entries: [], error: "Permission denied" };
+    }
+    const realDeny = browseDenyReason(realPath.split(path.sep).join("/"));
+    if (realDeny) {
+        return { entries: [], error: `Access denied: ${realDeny}` };
+    }
+    let dirents;
+    try {
+        dirents = fs.readdirSync(realPath, { withFileTypes: true });
+    }
+    catch (err) {
+        const code = err.code;
+        if (code === "ENOENT")
+            return { entries: [], error: "Directory not found" };
+        if (code === "EACCES" || code === "EPERM")
+            return { entries: [], error: "Permission denied" };
+        return { entries: [], error: `Failed to read directory: ${code ?? String(err)}` };
+    }
+    const entries = [];
+    for (const d of dirents) {
+        if (!d.isDirectory())
+            continue;
+        if (d.name.startsWith("."))
+            continue;
+        entries.push({ name: d.name, type: "dir" });
+        if (entries.length >= MAX_ENTRIES)
+            break;
+    }
+    entries.sort((a, b) => a.name.localeCompare(b.name));
+    return { entries };
+}

package/dist/supervisor.d.ts

@@ -49,6 +49,7 @@ export declare class DaemonSupervisor {
     private fetchAttachedAgent;
     private handleAgentAttached;
     private handleAgentDetached;
+    private handleFilesystemBrowse;
     private handleWorkspaceSetupRequested;
     private scheduleWorkspaceSetupRetry;
     private clearWorkspaceSetupRetry;

package/dist/supervisor.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"supervisor.d.ts","sourceRoot":"","sources":["../src/supervisor.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACxD,OAAO,EAAE,YAAY,EAA2N,MAAM,aAAa,CAAC;AACpQ,OAAO,EACL,KAAK,kBAAkB,EAMxB,MAAM,aAAa,CAAC;AAiBrB;;;;GAIG;AACH,iBAAS,gBAAgB,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,OAAO,CAAC,CAa3E;AAED,OAAO,EAAE,gBAAgB,EAAE,CAAC;AAyB5B;;;;;;;;;;GAUG;AACH,qBAAa,gBAAgB;IAazB,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,GAAG;IAdtB,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAiC;IAC1D,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAqB;IACpD,OAAO,CAAC,QAAQ,CAAC,qBAAqB,CAAqB;IAC3D,OAAO,CAAC,QAAQ,CAAC,yBAAyB,CAAqC;IAC/E,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAqB;IACrD,OAAO,CAAC,EAAE,CAAyB;IACnC,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,YAAY,CAAuB;IAC3C,OAAO,CAAC,gBAAgB,CAAoB;IAC5C,OAAO,CAAC,WAAW,CAA6B;gBAG7B,MAAM,EAAE,kBAAkB,EAC1B,MAAM,EAAE,YAAY,EACpB,GAAG,EAAE,aAAa;IAGrC,yEAAyE;IACnE,GAAG,CAAC,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IAiF7C,sEAAsE;IAChE,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;YAiCb,kBAAkB;YAqClB,aAAa;IAqD3B;;;;OAIG;IACH,OAAO,CAAC,iBAAiB;YA6CX,kBAAkB;YAqBlB,mBAAmB;YAgBnB,mBAAmB;YAmBnB,6BAA6B;IAqC3C,OAAO,CAAC,2BAA2B;IAYnC,OAAO,CAAC,wBAAwB;YAUlB,oBAAoB;YAcpB,kBAAkB;YAYlB,eAAe;YAcf,UAAU;YAoBV,cAAc;IA2D5B,OAAO,CAAC,UAAU;YA0EJ,cAAc;IAyB5B,OAAO,CAAC,0BAA0B;CA8BnC"}
+{"version":3,"file":"supervisor.d.ts","sourceRoot":"","sources":["../src/supervisor.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACxD,OAAO,EAAE,YAAY,EAA6P,MAAM,aAAa,CAAC;AAEtS,OAAO,EACL,KAAK,kBAAkB,EAMxB,MAAM,aAAa,CAAC;AAiBrB;;;;GAIG;AACH,iBAAS,gBAAgB,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,OAAO,CAAC,CAa3E;AAED,OAAO,EAAE,gBAAgB,EAAE,CAAC;AAyB5B;;;;;;;;;;GAUG;AACH,qBAAa,gBAAgB;IAazB,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,GAAG;IAdtB,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAiC;IAC1D,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAqB;IACpD,OAAO,CAAC,QAAQ,CAAC,qBAAqB,CAAqB;IAC3D,OAAO,CAAC,QAAQ,CAAC,yBAAyB,CAAqC;IAC/E,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAqB;IACrD,OAAO,CAAC,EAAE,CAAyB;IACnC,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,YAAY,CAAuB;IAC3C,OAAO,CAAC,gBAAgB,CAAoB;IAC5C,OAAO,CAAC,WAAW,CAA6B;gBAG7B,MAAM,EAAE,kBAAkB,EAC1B,MAAM,EAAE,YAAY,EACpB,GAAG,EAAE,aAAa;IAGrC,yEAAyE;IACnE,GAAG,CAAC,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IAsF7C,sEAAsE;IAChE,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;YAiCb,kBAAkB;YAqClB,aAAa;IAqD3B;;;;OAIG;IACH,OAAO,CAAC,iBAAiB;YA6CX,kBAAkB;YAqBlB,mBAAmB;YAgBnB,mBAAmB;YAmBnB,sBAAsB;YAwBtB,6BAA6B;IAqC3C,OAAO,CAAC,2BAA2B;IAYnC,OAAO,CAAC,wBAAwB;YAUlB,oBAAoB;YAcpB,kBAAkB;YAYlB,eAAe;YAcf,UAAU;YAoBV,cAAc;IA2D5B,OAAO,CAAC,UAAU;YA0EJ,cAAc;IAyB5B,OAAO,CAAC,0BAA0B;CA8BnC"}

package/dist/supervisor.js

@@ -2,6 +2,7 @@ import { spawn } from "node:child_process";
 import * as fs from "node:fs";
 import * as path from "node:path";
 import { ParallWs } from "@parall/sdk";
+import { listDirectory } from "./filesystem.js";
 import { agentClaudeCredentialsFileFor, agentClaudeHomeFor, agentStateDirFor, agentWorkspaceDirFor, sharedClaudeCredentialsFileFor, } from "./config.js";
 import { assertAgentKey, getRuntimeAdapter } from "./runtimes.js";
 import { prepareWorkspace } from "./workspace.js";
@@ -117,6 +118,10 @@ export class DaemonSupervisor {
             this.log.info(`WS: workspace setup requested for agent ${data.agent_id}`);
             void this.handleWorkspaceSetupRequested(data.agent_id);
         });
+        this.ws.on("machine.filesystem.browse", (data) => {
+            this.log.info(`WS: filesystem browse requested: ${data.path}`);
+            void this.handleFilesystemBrowse(data.request_id, data.path);
+        });
         this.ws.on("machine.stop", (data) => {
             this.log.info(`WS: machine.stop received (reason=${data.reason ?? "none"})`);
             void this.stop();
@@ -343,6 +348,31 @@ export class DaemonSupervisor {
         await this.terminateChild(state);
         this.children.delete(agentId);
     }
+    async handleFilesystemBrowse(requestId, dirPath) {
+        try {
+            const result = await listDirectory(dirPath);
+            await this.client.postBrowseResponse(requestId, {
+                request_id: requestId,
+                path: dirPath,
+                entries: result.entries,
+                error: result.error,
+            });
+        }
+        catch (err) {
+            this.log.warn(`filesystem browse failed: ${String(err)}`);
+            try {
+                await this.client.postBrowseResponse(requestId, {
+                    request_id: requestId,
+                    path: dirPath,
+                    entries: [],
+                    error: String(err),
+                });
+            }
+            catch {
+                // best-effort
+            }
+        }
+    }
     async handleWorkspaceSetupRequested(agentId) {
         if (this.spawningAgents.has(agentId)) {
             this.log.info(`agent ${agentId}: workspace setup already in progress; queueing one restart`);

package/dist/workspace.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"workspace.d.ts","sourceRoot":"","sources":["../src/workspace.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACxD,OAAO,KAAK,EAAE,aAAa,EAA4C,YAAY,EAAE,MAAM,aAAa,CAAC;AAiBzG,MAAM,WAAW,oBAAoB;IACnC,MAAM,EAAE,YAAY,CAAC;IACrB,QAAQ,EAAE,aAAa,CAAC;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,mBAAmB,EAAE,MAAM,CAAC;IAC5B,GAAG,EAAE,aAAa,CAAC;CACpB;AAED,wBAAsB,gBAAgB,CAAC,IAAI,EAAE,oBAAoB,GAAG,OAAO,CAAC,MAAM,CAAC,CA6ClF"}
+{"version":3,"file":"workspace.d.ts","sourceRoot":"","sources":["../src/workspace.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACxD,OAAO,KAAK,EAAE,aAAa,EAA4C,YAAY,EAAE,MAAM,aAAa,CAAC;AAiBzG,MAAM,WAAW,oBAAoB;IACnC,MAAM,EAAE,YAAY,CAAC;IACrB,QAAQ,EAAE,aAAa,CAAC;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,mBAAmB,EAAE,MAAM,CAAC;IAC5B,GAAG,EAAE,aAAa,CAAC;CACpB;AAED,wBAAsB,gBAAgB,CAAC,IAAI,EAAE,oBAAoB,GAAG,OAAO,CAAC,MAAM,CAAC,CA8ClF"}

package/dist/workspace.js

@@ -8,7 +8,8 @@ const DEFAULT_SETUP_TIMEOUT_SEC = 600;
 export async function prepareWorkspace(opts) {
     const prior = opts.attached.workspace_state;
     const plan = buildWorkspacePlan(opts.attached.daemon_config, opts.defaultWorkspaceDir, prior?.config_hash);
-    if (!opts.attached.daemon_config && !prior) {
+    const hasConfig = opts.attached.daemon_config && Object.keys(opts.attached.daemon_config).length > 0;
+    if (!hasConfig && !prior) {
         return plan.workspaceDir;
     }
     let forceSetup = false;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@parall/daemon",
-  "version": "1.29.2",
+  "version": "1.30.0",
   "description": "Parall local agent runtime — daemon supervisor + bridge runtimes, bundled as standalone JS files",
   "license": "MIT",
   "repository": {
@@ -29,11 +29,11 @@
     "dist"
   ],
   "dependencies": {
-    "@parall/sdk": "1.29.2",
-    "@parall/codex-agent": "1.29.2",
-    "@parall/claude-agent": "1.29.2",
-    "@parall/agent-core": "1.29.2",
-    "@parall/openclaw-agent": "1.29.2"
+    "@parall/agent-core": "1.30.0",
+    "@parall/sdk": "1.30.0",
+    "@parall/claude-agent": "1.30.0",
+    "@parall/codex-agent": "1.30.0",
+    "@parall/openclaw-agent": "1.30.0"
   },
   "devDependencies": {
     "@types/node": "^22.0.0",