@prbe.ai/electron-sdk 0.1.0

package/dist/tools/bash.js

@@ -0,0 +1,247 @@
+"use strict";
+/**
+ * tools/bash.ts — BashExecuteTool
+ *
+ * Allows the agent to execute shell commands during investigations.
+ * Uses a whitelist-only safety model: commands on the whitelist run without
+ * permission; everything else requires user approval.
+ *
+ * Platform-aware: uses separate whitelists for Unix and Windows, and
+ * runs commands via PowerShell on Windows for consistent behavior.
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BashExecuteTool = void 0;
+const child_process_1 = require("child_process");
+const crypto_1 = require("crypto");
+const path = __importStar(require("path"));
+const models_1 = require("../models");
+const interactions_1 = require("../interactions");
+const index_1 = require("./index");
+// ---------------------------------------------------------------------------
+// Platform detection
+// ---------------------------------------------------------------------------
+const IS_WINDOWS = process.platform === "win32";
+// ---------------------------------------------------------------------------
+// Safe commands whitelist (read-only / informational only)
+// ---------------------------------------------------------------------------
+const UNIX_SAFE_COMMANDS = new Set([
+    "ls", "cat", "head", "tail", "grep", "rg", "find", "which",
+    "whoami", "pwd", "echo", "printf", "wc", "sort", "uniq",
+    "diff", "file", "stat", "du", "df", "uname", "env", "printenv",
+    "date", "id", "hostname", "ps", "top", "uptime", "free",
+]);
+const WINDOWS_SAFE_COMMANDS = new Set([
+    "dir", "type", "findstr", "where", "whoami", "echo",
+    "sort", "fc", "hostname", "date", "systeminfo", "tasklist",
+    "set", "ver", "vol", "tree",
+    // PowerShell cmdlets (when shell is PowerShell)
+    "get-childitem", "get-content", "select-string", "get-process",
+    "get-date", "get-host", "get-computerinfo", "get-volume",
+    "test-path", "resolve-path", "measure-object",
+]);
+const SAFE_COMMANDS = IS_WINDOWS ? WINDOWS_SAFE_COMMANDS : UNIX_SAFE_COMMANDS;
+/** Two-word commands that are also safe (cross-platform — git/node/npm) */
+const SAFE_COMMAND_PREFIXES = new Set([
+    "git status",
+    "git log",
+    "git diff",
+    "git show",
+    "git branch",
+    "node --version",
+    "npm --version",
+    "npm list",
+    "npm ls",
+]);
+const MAX_OUTPUT_BYTES = 100 * 1024; // 100KB
+const DEFAULT_TIMEOUT_MS = 30_000;
+const MAX_TIMEOUT_MS = 120_000;
+// ---------------------------------------------------------------------------
+// BashExecuteTool
+// ---------------------------------------------------------------------------
+class BashExecuteTool {
+    requester;
+    allowedRoots;
+    grantedPaths;
+    constructor(requester, allowedRoots, grantedPaths) {
+        this.requester = requester;
+        this.allowedRoots = allowedRoots;
+        this.grantedPaths = grantedPaths;
+    }
+    get declaration() {
+        return {
+            name: models_1.ToolName.CLIENT_BASH_EXECUTE,
+            description: "Execute a shell command on the user's machine. Safe read-only commands run immediately; potentially destructive commands require user approval first.",
+            parameters: [
+                {
+                    name: "command",
+                    type: models_1.ToolParamType.STRING,
+                    description: "The shell command to execute",
+                    required: true,
+                },
+                {
+                    name: "cwd",
+                    type: models_1.ToolParamType.STRING,
+                    description: "Working directory for the command (must be within allowed roots)",
+                    required: false,
+                },
+                {
+                    name: "timeout",
+                    type: models_1.ToolParamType.INTEGER,
+                    description: "Timeout in seconds (default 30, max 120)",
+                    required: false,
+                },
+            ],
+        };
+    }
+    async execute(args) {
+        const command = args["command"];
+        if (!command)
+            return "Error: 'command' parameter is required";
+        const cwdArg = args["cwd"];
+        const timeoutSec = typeof args["timeout"] === "number" ? args["timeout"] : DEFAULT_TIMEOUT_MS / 1000;
+        const timeoutMs = Math.min(timeoutSec * 1000, MAX_TIMEOUT_MS);
+        // Validate cwd if provided
+        let cwd;
+        if (cwdArg) {
+            const allRoots = [...this.allowedRoots, ...this.grantedPaths];
+            const resolved = (0, index_1.resolveAndValidate)(cwdArg, allRoots);
+            if (!resolved) {
+                return `Error: working directory '${cwdArg}' is outside allowed roots`;
+            }
+            cwd = resolved;
+        }
+        // Check if command is safe (whitelist-only)
+        const isSafe = this.isCommandSafe(command);
+        if (!isSafe) {
+            const response = await this.requester.requestUserInteraction({
+                type: interactions_1.InteractionType.REQUEST_PERMISSION,
+                interactionId: (0, crypto_1.randomUUID)(),
+                action: "Execute shell command",
+                command,
+                reason: `The agent wants to run this command${cwd ? ` in ${cwd}` : ""}.`,
+            });
+            const permResponse = response;
+            if (!permResponse.approved) {
+                return "Command execution denied by user.";
+            }
+        }
+        // Execute the command
+        return new Promise((resolve) => {
+            (0, child_process_1.exec)(command, {
+                cwd,
+                timeout: timeoutMs,
+                maxBuffer: MAX_OUTPUT_BYTES,
+                env: process.env,
+                // On Windows, use PowerShell for more consistent behavior
+                ...(IS_WINDOWS ? { shell: "powershell.exe" } : {}),
+            }, (error, stdout, stderr) => {
+                let output = "";
+                if (stdout) {
+                    output += stdout;
+                }
+                if (stderr) {
+                    if (output)
+                        output += "\n--- stderr ---\n";
+                    output += stderr;
+                }
+                if (error) {
+                    if (error.killed) {
+                        output += `\n[Command timed out after ${timeoutSec}s]`;
+                    }
+                    else if (!stdout && !stderr) {
+                        output = `Error: ${error.message}`;
+                    }
+                }
+                // Truncate if too large
+                if (Buffer.byteLength(output, "utf-8") > MAX_OUTPUT_BYTES) {
+                    output = output.slice(0, MAX_OUTPUT_BYTES) + "\n[Output truncated at 100KB]";
+                }
+                resolve(output || "(no output)");
+            });
+        });
+    }
+    /**
+     * Check if a command is on the safe whitelist.
+     */
+    isCommandSafe(command) {
+        const trimmed = command.trim();
+        // Check two-word prefixes first (e.g. "git status")
+        for (const prefix of SAFE_COMMAND_PREFIXES) {
+            if (trimmed === prefix || trimmed.startsWith(prefix + " ")) {
+                return true;
+            }
+        }
+        // Extract base command
+        const firstCommand = IS_WINDOWS
+            ? trimmed.split(/[|;]/, 1)[0].trim() // PowerShell uses | and ;
+            : trimmed.split(/[|;&]/, 1)[0].trim(); // bash uses |, ;, &
+        const baseCommand = firstCommand.split(/\s+/, 1)[0];
+        const commandName = IS_WINDOWS
+            ? baseCommand.toLowerCase() // Windows commands are case-insensitive
+            : path.basename(baseCommand);
+        if (SAFE_COMMANDS.has(commandName)) {
+            return this.areAllPipeSegmentsSafe(trimmed);
+        }
+        return false;
+    }
+    /**
+     * For piped commands, check that every segment uses a safe command.
+     */
+    areAllPipeSegmentsSafe(command) {
+        // Chained commands (;, &&, ||) require permission
+        if (IS_WINDOWS) {
+            if (/;/.test(command) && command.split("|").length <= 1)
+                return false;
+        }
+        else {
+            if (/[;&]|&&|\|\|/.test(command))
+                return false;
+        }
+        const segments = command.split("|").map((s) => s.trim());
+        for (const segment of segments) {
+            const baseCommand = segment.split(/\s+/, 1)[0];
+            const commandName = IS_WINDOWS
+                ? baseCommand.toLowerCase()
+                : path.basename(baseCommand);
+            if (!SAFE_COMMANDS.has(commandName)) {
+                return false;
+            }
+        }
+        return true;
+    }
+}
+exports.BashExecuteTool = BashExecuteTool;
+//# sourceMappingURL=bash.js.map

package/dist/tools/bash.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bash.js","sourceRoot":"","sources":["../../src/tools/bash.ts"],"names":[],"mappings":"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"}

package/dist/tools/filesystem.d.ts

@@ -0,0 +1,63 @@
+/**
+ * tools/filesystem.ts — Built-in filesystem tools
+ *
+ * Implements: client_list_directory, client_read_file, client_search_content,
+ *             client_find_files, client_flag_file
+ *
+ * Mirrors PRBEAgentTools.swift filesystem tool implementations.
+ */
+import type { PRBEToolDeclaration, FlaggedFileIn } from "../models";
+import type { PRBEInteractionRequester } from "../interactions";
+import type { PRBETool } from "./index";
+export declare class ListDirectoryTool implements PRBETool {
+    private readonly allowedRoots;
+    private readonly requester?;
+    private readonly grantedPaths?;
+    constructor(allowedRoots: string[], requester?: PRBEInteractionRequester, grantedPaths?: Set<string>);
+    get declaration(): PRBEToolDeclaration;
+    execute(args: Record<string, unknown>): Promise<string>;
+    private static readonly MAX_ENTRIES;
+    private listDir;
+}
+export declare class ReadFileTool implements PRBETool {
+    private readonly allowedRoots;
+    private readonly requester?;
+    private readonly grantedPaths?;
+    constructor(allowedRoots: string[], requester?: PRBEInteractionRequester, grantedPaths?: Set<string>);
+    get declaration(): PRBEToolDeclaration;
+    execute(args: Record<string, unknown>): Promise<string>;
+}
+export declare class SearchContentTool implements PRBETool {
+    private readonly allowedRoots;
+    private readonly requester?;
+    private readonly grantedPaths?;
+    constructor(allowedRoots: string[], requester?: PRBEInteractionRequester, grantedPaths?: Set<string>);
+    get declaration(): PRBEToolDeclaration;
+    execute(args: Record<string, unknown>): Promise<string>;
+    private collectFiles;
+}
+export declare class FindFilesTool implements PRBETool {
+    private readonly allowedRoots;
+    private readonly requester?;
+    private readonly grantedPaths?;
+    constructor(allowedRoots: string[], requester?: PRBEInteractionRequester, grantedPaths?: Set<string>);
+    get declaration(): PRBEToolDeclaration;
+    execute(args: Record<string, unknown>): Promise<string>;
+    private walkAndMatch;
+    /**
+     * Simple glob matching: supports *, ?, and character classes [...].
+     * Converts glob to regex and tests against the filename.
+     */
+    private globMatch;
+}
+export declare class FlagFileTool implements PRBETool {
+    private readonly allowedRoots;
+    private readonly onFlag;
+    private readonly requester?;
+    private readonly grantedPaths?;
+    private static readonly MAX_BINARY_SIZE;
+    constructor(allowedRoots: string[], onFlag: (file: FlaggedFileIn) => void, requester?: PRBEInteractionRequester, grantedPaths?: Set<string>);
+    get declaration(): PRBEToolDeclaration;
+    execute(args: Record<string, unknown>): Promise<string>;
+}
+//# sourceMappingURL=filesystem.d.ts.map

package/dist/tools/filesystem.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"filesystem.d.ts","sourceRoot":"","sources":["../../src/tools/filesystem.ts"],"names":[],"mappings":"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"}