@aria-cli/tools 1.0.19 → 1.0.31

package/dist-cjs/definitions/process/session-slug.js

@@ -0,0 +1,146 @@
+"use strict";
+// Originally from OpenClaw (MIT License, Copyright 2025 Peter Steinberger)
+// https://github.com/openclaw/openclaw
+// Modified for ARIA — stripped OpenClaw runtime, rewired to ARIA Tool interface
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createSessionSlug = createSessionSlug;
+const SLUG_ADJECTIVES = [
+    "amber",
+    "briny",
+    "brisk",
+    "calm",
+    "clear",
+    "cool",
+    "crisp",
+    "dawn",
+    "delta",
+    "ember",
+    "faint",
+    "fast",
+    "fresh",
+    "gentle",
+    "glow",
+    "good",
+    "grand",
+    "keen",
+    "kind",
+    "lucky",
+    "marine",
+    "mellow",
+    "mild",
+    "neat",
+    "nimble",
+    "nova",
+    "oceanic",
+    "plaid",
+    "quick",
+    "quiet",
+    "rapid",
+    "salty",
+    "sharp",
+    "swift",
+    "tender",
+    "tidal",
+    "tidy",
+    "tide",
+    "vivid",
+    "warm",
+    "wild",
+    "young",
+];
+const SLUG_NOUNS = [
+    "atlas",
+    "basil",
+    "bison",
+    "bloom",
+    "breeze",
+    "canyon",
+    "cedar",
+    "claw",
+    "cloud",
+    "comet",
+    "coral",
+    "cove",
+    "crest",
+    "crustacean",
+    "daisy",
+    "dune",
+    "ember",
+    "falcon",
+    "fjord",
+    "forest",
+    "glade",
+    "gulf",
+    "harbor",
+    "haven",
+    "kelp",
+    "lagoon",
+    "lobster",
+    "meadow",
+    "mist",
+    "nudibranch",
+    "nexus",
+    "ocean",
+    "orbit",
+    "otter",
+    "pine",
+    "prairie",
+    "reef",
+    "ridge",
+    "river",
+    "rook",
+    "sable",
+    "sage",
+    "seaslug",
+    "shell",
+    "shoal",
+    "shore",
+    "slug",
+    "summit",
+    "tidepool",
+    "trail",
+    "valley",
+    "wharf",
+    "willow",
+    "zephyr",
+];
+function randomChoice(values, fallback) {
+    return values[Math.floor(Math.random() * values.length)] ?? fallback;
+}
+function createSlugBase(words = 2) {
+    const parts = [randomChoice(SLUG_ADJECTIVES, "steady"), randomChoice(SLUG_NOUNS, "harbor")];
+    if (words > 2) {
+        parts.push(randomChoice(SLUG_NOUNS, "reef"));
+    }
+    return parts.join("-");
+}
+function createSessionSlug(isTaken) {
+    const isIdTaken = isTaken ?? (() => false);
+    for (let attempt = 0; attempt < 12; attempt += 1) {
+        const base = createSlugBase(2);
+        if (!isIdTaken(base)) {
+            return base;
+        }
+        for (let i = 2; i <= 12; i += 1) {
+            const candidate = `${base}-${i}`;
+            if (!isIdTaken(candidate)) {
+                return candidate;
+            }
+        }
+    }
+    for (let attempt = 0; attempt < 12; attempt += 1) {
+        const base = createSlugBase(3);
+        if (!isIdTaken(base)) {
+            return base;
+        }
+        for (let i = 2; i <= 12; i += 1) {
+            const candidate = `${base}-${i}`;
+            if (!isIdTaken(candidate)) {
+                return candidate;
+            }
+        }
+    }
+    const fallback = `${createSlugBase(3)}-${Math.random().toString(36).slice(2, 5)}`;
+    return isIdTaken(fallback) ? `${fallback}-${Date.now().toString(36)}` : fallback;
+}
+//# sourceMappingURL=session-slug.js.map

package/dist-cjs/definitions/quip.js

@@ -0,0 +1,199 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.QUIP_TOOL_DEFINITIONS = void 0;
+const node_child_process_1 = require("node:child_process");
+const node_os_1 = require("node:os");
+const node_path_1 = require("node:path");
+const QUIP_PY = (0, node_path_1.join)((0, node_os_1.homedir)(), ".aria", "tools", "quip.py");
+function runQuip(args) {
+    return new Promise((resolve, reject) => {
+        (0, node_child_process_1.execFile)(QUIP_PY, args, { timeout: 30_000 }, (err, stdout, stderr) => {
+            if (err) {
+                reject(new Error(stderr?.trim() || err.message));
+            }
+            else {
+                resolve(stdout);
+            }
+        });
+    });
+}
+const check_quip_documents = {
+    name: "check_quip_documents",
+    description: "Read, search, or list Quip documents and comments using the local Quip session on this machine. " +
+        "Actions: 'recent' lists recent docs, 'search' finds docs by query, 'read' gets full document content, 'comments' lists comments on a document.",
+    category: "messaging",
+    parameters: {
+        type: "object",
+        properties: {
+            action: {
+                type: "string",
+                enum: ["recent", "search", "read", "comments"],
+                description: "What to do: 'recent' (list recent docs), 'search' (find docs), 'read' (get document content), 'comments' (list comments).",
+            },
+            query: {
+                type: "string",
+                description: "Search query (required for 'search' action).",
+            },
+            threadId: {
+                type: "string",
+                description: "Quip thread/document ID (required for 'read' and 'comments' actions).",
+            },
+            limit: {
+                type: "number",
+                description: "Maximum number of results to return (default 20, max 50).",
+                default: 20,
+            },
+        },
+        required: ["action"],
+    },
+    riskLevel: "safe",
+    isReadOnly: true,
+    loadingTier: "always",
+    execute: async (input) => {
+        const typedInput = input;
+        try {
+            const action = String(typedInput.action ?? "recent");
+            const limit = String(typeof typedInput.limit === "number" ? typedInput.limit : 20);
+            if (action === "recent") {
+                const raw = await runQuip(["recent", limit]);
+                return { success: true, message: `Recent Quip documents.`, data: { output: raw } };
+            }
+            if (action === "search") {
+                const query = String(typedInput.query ?? "");
+                if (!query)
+                    return { success: false, message: "'search' requires a 'query' parameter." };
+                const raw = await runQuip(["search", query, "--limit", limit]);
+                return { success: true, message: `Search results for "${query}".`, data: { output: raw } };
+            }
+            if (action === "read") {
+                const threadId = String(typedInput.threadId ?? "");
+                if (!threadId)
+                    return { success: false, message: "'read' requires a 'threadId' parameter." };
+                const raw = await runQuip(["read", threadId]);
+                return { success: true, message: `Read document ${threadId}.`, data: { output: raw } };
+            }
+            if (action === "comments") {
+                const threadId = String(typedInput.threadId ?? "");
+                if (!threadId)
+                    return { success: false, message: "'comments' requires a 'threadId' parameter." };
+                const raw = await runQuip(["comments", threadId]);
+                return { success: true, message: `Comments on ${threadId}.`, data: { output: raw } };
+            }
+            return {
+                success: false,
+                message: `Unknown action: ${action}. Use recent, search, read, or comments.`,
+            };
+        }
+        catch (error) {
+            return {
+                success: false,
+                message: error instanceof Error ? error.message : "Quip read failed.",
+            };
+        }
+    },
+};
+const send_quip_comment = {
+    name: "send_quip_comment",
+    description: "Add a comment to a Quip document using the local Quip session on this machine. " +
+        "Requires confirmation because it posts externally.",
+    category: "messaging",
+    parameters: {
+        type: "object",
+        properties: {
+            threadId: {
+                type: "string",
+                description: "Quip thread/document ID to comment on.",
+            },
+            content: {
+                type: "string",
+                description: "Comment text to post.",
+            },
+        },
+        required: ["threadId", "content"],
+    },
+    riskLevel: "dangerous",
+    requiresConfirmation: true,
+    isReadOnly: false,
+    loadingTier: "always",
+    execute: async (input) => {
+        const typedInput = input;
+        try {
+            const raw = await runQuip([
+                "comment",
+                String(typedInput.threadId ?? ""),
+                String(typedInput.content ?? ""),
+            ]);
+            return { success: true, message: `Posted comment.`, data: { output: raw } };
+        }
+        catch (error) {
+            return {
+                success: false,
+                message: error instanceof Error ? error.message : "Quip comment failed.",
+            };
+        }
+    },
+};
+const create_quip_document = {
+    name: "create_quip_document",
+    description: "Create a new Quip document using the local Quip session on this machine. " +
+        "Requires confirmation because it creates external content.",
+    category: "messaging",
+    parameters: {
+        type: "object",
+        properties: {
+            title: {
+                type: "string",
+                description: "Document title.",
+            },
+            content: {
+                type: "string",
+                description: "Document body content.",
+            },
+            format: {
+                type: "string",
+                enum: ["markdown", "html"],
+                description: "Content format (default 'markdown').",
+                default: "markdown",
+            },
+            folderId: {
+                type: "string",
+                description: "Optional folder ID to place the document in.",
+            },
+        },
+        required: ["title", "content"],
+    },
+    riskLevel: "dangerous",
+    requiresConfirmation: true,
+    isReadOnly: false,
+    loadingTier: "always",
+    execute: async (input) => {
+        const typedInput = input;
+        try {
+            const args = [
+                "create",
+                "--title",
+                String(typedInput.title ?? ""),
+                "--body",
+                String(typedInput.content ?? ""),
+            ];
+            if (typedInput.format)
+                args.push("--format", typedInput.format);
+            if (typedInput.folderId)
+                args.push("--folder", typedInput.folderId);
+            const raw = await runQuip(args);
+            return { success: true, message: `Created document.`, data: { output: raw } };
+        }
+        catch (error) {
+            return {
+                success: false,
+                message: error instanceof Error ? error.message : "Quip create failed.",
+            };
+        }
+    },
+};
+exports.QUIP_TOOL_DEFINITIONS = [
+    check_quip_documents,
+    send_quip_comment,
+    create_quip_document,
+];
+//# sourceMappingURL=quip.js.map

package/dist-cjs/definitions/search.js

@@ -0,0 +1,64 @@
+"use strict";
+/**
+ * Native indexed regex search tool definition.
+ *
+ * Uses @aria-cli/search (Rust napi-rs addon) for sub-millisecond indexed search.
+ * Registered alongside (not replacing) the existing grep tool.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SEARCH_TOOL_DEFINITIONS = exports.searchTool = void 0;
+const search_js_1 = require("../executors/search.js");
+exports.searchTool = {
+    name: "grep",
+    description: "Search for patterns in files using regular expressions. Indexed for sub-millisecond speed. Builds index automatically on first use. Supports regex, literal strings, file type filters, and glob patterns.",
+    category: "filesystem",
+    parameters: {
+        type: "object",
+        properties: {
+            pattern: {
+                type: "string",
+                description: "Regex pattern to search for. Use literal: true for exact string matching.",
+            },
+            directory: {
+                type: "string",
+                description: "Directory to search in (default: current working directory)",
+                default: ".",
+            },
+            fileGlob: {
+                type: "string",
+                description: "Glob pattern to filter files (e.g. '*.ts', 'src/**/*.rs')",
+            },
+            fileType: {
+                type: "string",
+                description: "File extension filter (e.g. 'ts', 'rs', 'py'). Simpler than glob for single types.",
+            },
+            caseSensitive: {
+                type: "boolean",
+                description: "Case-sensitive matching (default: true)",
+                default: true,
+            },
+            literal: {
+                type: "boolean",
+                description: "Treat pattern as a literal string, not regex (default: false)",
+                default: false,
+            },
+            maxResults: {
+                type: "number",
+                description: "Maximum number of matches to return (default: 1000)",
+                default: 1000,
+            },
+            context: {
+                type: "number",
+                description: "Number of context lines before and after each match (default: 0)",
+                default: 0,
+            },
+        },
+        required: ["pattern"],
+    },
+    riskLevel: "safe",
+    isReadOnly: true,
+    loadingTier: "always",
+    execute: search_js_1.executeSearch,
+};
+exports.SEARCH_TOOL_DEFINITIONS = [exports.searchTool];
+//# sourceMappingURL=search.js.map

package/dist-cjs/definitions/session-history.js

@@ -0,0 +1,73 @@
+"use strict";
+/**
+ * Session History tool definitions
+ *
+ * Tools: session_history (1 tool with multi-action pattern)
+ *
+ * Provides list, search, get, current, stats, delete, and set_title
+ * actions against the SessionHistory SQLite database.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SESSION_HISTORY_TOOL_DEFINITIONS = void 0;
+const session_history_js_1 = require("../executors/session-history.js");
+const sessionHistory = {
+    name: "session_history",
+    description: "List, search, and manage conversation session history. Actions: " +
+        "'list' shows recent sessions, 'search' finds sessions by message content (full-text search), " +
+        "'get' retrieves a full session transcript, 'current' shows current session info, " +
+        "'stats' shows session statistics, 'delete' removes a session, " +
+        "'set_title' renames a session.",
+    category: "memory",
+    parameters: {
+        type: "object",
+        properties: {
+            action: {
+                type: "string",
+                enum: ["list", "search", "get", "current", "stats", "delete", "set_title"],
+                description: "Action to perform",
+            },
+            query: {
+                type: "string",
+                description: "Search query (required for 'search' action)",
+            },
+            sessionId: {
+                type: "string",
+                description: "Session ID or prefix — 8+ chars for prefix match, full UUID for exact match (required for 'get', 'delete', 'set_title')",
+            },
+            title: {
+                type: "string",
+                description: "New title (required for 'set_title' action)",
+            },
+            limit: {
+                type: "number",
+                description: "Maximum number of results to return (default 20)",
+                default: 20,
+            },
+            offset: {
+                type: "number",
+                description: "Pagination offset (default 0)",
+                default: 0,
+            },
+            messageLimit: {
+                type: "number",
+                description: "Maximum messages to return per session for 'get' action (default 50)",
+                default: 50,
+            },
+        },
+        required: ["action"],
+    },
+    riskLevel: "moderate",
+    isReadOnly: false,
+    loadingTier: "deferred",
+    // Only 'delete' needs confirmation — all other actions are safe
+    skipApprovalForInput: (input) => {
+        const i = input;
+        return i?.action !== "delete";
+    },
+    execute: (input, ctx) => {
+        return (0, session_history_js_1.executeSessionHistory)(input, ctx);
+    },
+};
+/** Session History tool definitions (1) */
+exports.SESSION_HISTORY_TOOL_DEFINITIONS = [sessionHistory];
+//# sourceMappingURL=session-history.js.map

package/dist-cjs/definitions/shell.js

@@ -0,0 +1,185 @@
+"use strict";
+/**
+ * Shell tool definitions
+ *
+ * Tools: bash, exec, spawn, kill, write_stdin, list_processes, wait_process (7 tools)
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SHELL_TOOL_DEFINITIONS = void 0;
+const index_js_1 = require("../executors/index.js");
+const shell_js_1 = require("../executors/shell.js");
+const shell_safety_js_1 = require("../executors/shell-safety.js");
+const bash = {
+    name: "bash",
+    description: "Execute a shell command in a bash environment. Returns stdout and stderr.",
+    category: "shell",
+    parameters: {
+        type: "object",
+        properties: {
+            command: { type: "string", description: "Command to execute" },
+            cwd: { type: "string", description: "Working directory" },
+            env: { type: "object", description: "Environment variables" },
+            timeout: { type: "number", description: "Timeout in milliseconds" },
+        },
+        required: ["command"],
+    },
+    riskLevel: "dangerous",
+    requiresConfirmation: true,
+    isReadOnly: false,
+    loadingTier: "always",
+    skipApprovalForInput: (input) => {
+        const cmd = input?.command;
+        return typeof cmd === "string" && (0, shell_safety_js_1.classifyCommand)(cmd) === "safe";
+    },
+    execute: index_js_1.executeBash,
+};
+const exec = {
+    name: "exec",
+    description: "Execute a program directly without shell interpretation. Safer than bash for untrusted input.",
+    category: "shell",
+    parameters: {
+        type: "object",
+        properties: {
+            program: { type: "string", description: "Program to execute" },
+            args: {
+                type: "array",
+                items: { type: "string" },
+                description: "Command arguments",
+            },
+            cwd: { type: "string", description: "Working directory" },
+            env: { type: "object", description: "Environment variables" },
+            timeout: { type: "number", description: "Timeout in milliseconds" },
+        },
+        required: ["program"],
+    },
+    riskLevel: "dangerous",
+    isReadOnly: false,
+    loadingTier: "always",
+    execute: index_js_1.executeExec,
+};
+const spawn = {
+    name: "spawn",
+    description: "Start a long-running process in the background. Returns a process ID for management.",
+    category: "shell",
+    parameters: {
+        type: "object",
+        properties: {
+            program: { type: "string", description: "Program to spawn" },
+            args: {
+                type: "array",
+                items: { type: "string" },
+                description: "Command arguments",
+            },
+            cwd: { type: "string", description: "Working directory" },
+            env: { type: "object", description: "Environment variables" },
+            interactive: {
+                type: "boolean",
+                description: "Start as interactive PTY session (enables write_stdin). Default: false",
+                default: false,
+            },
+        },
+        required: ["program"],
+    },
+    riskLevel: "dangerous",
+    isReadOnly: false,
+    loadingTier: "always",
+    execute: index_js_1.executeSpawn,
+};
+const kill = {
+    name: "kill",
+    description: "Terminate a running process by its process ID.",
+    category: "shell",
+    parameters: {
+        type: "object",
+        properties: {
+            pid: { type: "number", description: "Process ID to kill" },
+            signal: {
+                type: "string",
+                description: "Signal to send",
+                default: "SIGTERM",
+            },
+        },
+        required: ["pid"],
+    },
+    riskLevel: "dangerous",
+    requiresConfirmation: true,
+    isReadOnly: false,
+    loadingTier: "always",
+    execute: index_js_1.executeKill,
+};
+const write_stdin = {
+    name: "write_stdin",
+    description: "Send input to an interactive PTY session by PID. Use after spawning a process with interactive=true. Returns recent output from the session.",
+    category: "shell",
+    parameters: {
+        type: "object",
+        properties: {
+            pid: { type: "number", description: "PID of the interactive process" },
+            input: { type: "string", description: "Input string to send to the process" },
+            timeout: {
+                type: "number",
+                description: "Milliseconds to wait for output after writing (max 30000)",
+            },
+        },
+        required: ["pid", "input"],
+    },
+    riskLevel: "moderate",
+    isReadOnly: false,
+    loadingTier: "always",
+    execute: index_js_1.executeWriteStdin,
+};
+const list_processes = {
+    name: "list_processes",
+    description: "List tracked shell processes started in this session with metadata and runtime status.",
+    category: "shell",
+    parameters: {
+        type: "object",
+        properties: {
+            includeExited: {
+                type: "boolean",
+                description: "Include recently exited processes from registry history (default: false).",
+                default: false,
+            },
+        },
+        required: [],
+    },
+    riskLevel: "safe",
+    isReadOnly: true,
+    loadingTier: "always",
+    execute: shell_js_1.executeListProcesses,
+};
+const wait_process = {
+    name: "wait_process",
+    description: "Wait for a tracked process to exit and return exit metadata. Fails on timeout.",
+    category: "shell",
+    parameters: {
+        type: "object",
+        properties: {
+            pid: { type: "number", description: "PID of the process to wait for" },
+            timeoutMs: {
+                type: "number",
+                description: "Maximum milliseconds to wait (max 300000, default 30000).",
+            },
+            timeout: {
+                type: "number",
+                description: "Deprecated alias for timeoutMs.",
+            },
+        },
+        required: ["pid"],
+    },
+    riskLevel: "safe",
+    isReadOnly: true,
+    loadingTier: "always",
+    execute: shell_js_1.executeWaitProcess,
+};
+/** Shell tool definitions (7) */
+exports.SHELL_TOOL_DEFINITIONS = [
+    bash,
+    exec,
+    spawn,
+    kill,
+    write_stdin,
+    list_processes,
+    wait_process,
+];
+//# sourceMappingURL=shell.js.map