@aria-cli/tools 1.0.0

package/dist/definitions/shell.js

@@ -0,0 +1,182 @@
+/**
+ * Shell tool definitions
+ *
+ * Tools: bash, exec, spawn, kill, write_stdin, list_processes, wait_process (7 tools)
+ */
+import { executeBash, executeExec, executeSpawn, executeKill, executeWriteStdin, } from "../executors/index.js";
+import { executeListProcesses, executeWaitProcess } from "../executors/shell.js";
+import { classifyCommand } from "../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" && classifyCommand(cmd) === "safe";
+    },
+    execute: 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: 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: 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: 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: 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: 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: executeWaitProcess,
+};
+/** Shell tool definitions (7) */
+export const SHELL_TOOL_DEFINITIONS = [
+    bash,
+    exec,
+    spawn,
+    kill,
+    write_stdin,
+    list_processes,
+    wait_process,
+];
+//# sourceMappingURL=shell.js.map

package/dist/definitions/shell.js.map

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

package/dist/definitions/slack.d.ts

@@ -0,0 +1,3 @@
+import type { Tool } from "../types.js";
+export declare const SLACK_TOOL_DEFINITIONS: Tool[];
+//# sourceMappingURL=slack.d.ts.map

package/dist/definitions/slack.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"slack.d.ts","sourceRoot":"","sources":["../../src/definitions/slack.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,aAAa,CAAC;AA6MxC,eAAO,MAAM,sBAAsB,QAIlC,CAAC"}

package/dist/definitions/slack.js

@@ -0,0 +1,181 @@
+import { createSlackDesktopClient } from "../slack/desktop-session.js";
+const check_slack_messages = {
+    name: "check_slack_messages",
+    description: "Read recent Slack messages from a channel or DM using the local Slack Desktop session on this machine.",
+    category: "messaging",
+    parameters: {
+        type: "object",
+        properties: {
+            teamId: {
+                type: "string",
+                description: "Optional Slack team id to target when the local Slack Desktop app is signed into multiple workspaces.",
+            },
+            channel: {
+                type: "string",
+                description: "Slack conversation id (C/G/D...) or channel name.",
+            },
+            limit: {
+                type: "number",
+                description: "Maximum number of messages to return (default 20, max 100).",
+                default: 20,
+            },
+            threadTs: {
+                type: "string",
+                description: "Optional thread timestamp. When provided, reads thread replies instead of the root channel history.",
+            },
+        },
+        required: ["channel"],
+    },
+    riskLevel: "safe",
+    isReadOnly: true,
+    loadingTier: "always",
+    execute: async (input) => {
+        const typedInput = input;
+        const client = await createSlackDesktopClient({
+            teamId: typeof typedInput.teamId === "string" ? typedInput.teamId : undefined,
+        });
+        try {
+            const result = await client.listMessages({
+                channel: String(typedInput.channel ?? ""),
+                limit: typeof typedInput.limit === "number" ? typedInput.limit : 20,
+                threadTs: typeof typedInput.threadTs === "string" ? typedInput.threadTs : undefined,
+            });
+            return {
+                success: true,
+                message: `Fetched ${result.messages.length} Slack messages from ${result.channelId}.`,
+                data: result,
+            };
+        }
+        catch (error) {
+            return {
+                success: false,
+                message: error instanceof Error ? error.message : "Slack read failed.",
+            };
+        }
+        finally {
+            await client.close();
+        }
+    },
+};
+const send_slack_message = {
+    name: "send_slack_message",
+    description: "Send a Slack message through the local Slack Desktop session on this machine. Requires confirmation because it posts externally.",
+    category: "messaging",
+    parameters: {
+        type: "object",
+        properties: {
+            teamId: {
+                type: "string",
+                description: "Optional Slack team id to target when the local Slack Desktop app is signed into multiple workspaces.",
+            },
+            channel: {
+                type: "string",
+                description: "Slack conversation id (C/G/D...) or channel name.",
+            },
+            text: {
+                type: "string",
+                description: "Message text to send.",
+            },
+            threadTs: {
+                type: "string",
+                description: "Optional thread timestamp to reply inside an existing thread.",
+            },
+        },
+        required: ["channel", "text"],
+    },
+    riskLevel: "dangerous",
+    requiresConfirmation: true,
+    isReadOnly: false,
+    loadingTier: "always",
+    execute: async (input) => {
+        const typedInput = input;
+        const client = await createSlackDesktopClient({
+            teamId: typeof typedInput.teamId === "string" ? typedInput.teamId : undefined,
+        });
+        try {
+            const result = await client.sendMessage({
+                channel: String(typedInput.channel ?? ""),
+                text: String(typedInput.text ?? ""),
+                threadTs: typeof typedInput.threadTs === "string" ? typedInput.threadTs : undefined,
+            });
+            return {
+                success: true,
+                message: `Sent Slack message to ${result.channelId}.`,
+                data: result,
+            };
+        }
+        catch (error) {
+            return {
+                success: false,
+                message: error instanceof Error ? error.message : "Slack send failed.",
+            };
+        }
+        finally {
+            await client.close();
+        }
+    },
+};
+const react_slack_message = {
+    name: "react_slack_message",
+    description: "Add an emoji reaction to a Slack message using the local Slack Desktop session on this machine. Requires confirmation because it modifies external state.",
+    category: "messaging",
+    parameters: {
+        type: "object",
+        properties: {
+            teamId: {
+                type: "string",
+                description: "Optional Slack team id to target when the local Slack Desktop app is signed into multiple workspaces.",
+            },
+            channel: {
+                type: "string",
+                description: "Slack conversation id (C/G/D...) or channel name.",
+            },
+            timestamp: {
+                type: "string",
+                description: "Message timestamp to react to.",
+            },
+            name: {
+                type: "string",
+                description: "Emoji name without colons (e.g., thumbsup, eyes, white_check_mark).",
+            },
+        },
+        required: ["channel", "timestamp", "name"],
+    },
+    riskLevel: "dangerous",
+    requiresConfirmation: true,
+    isReadOnly: false,
+    loadingTier: "always",
+    execute: async (input) => {
+        const typedInput = input;
+        const client = await createSlackDesktopClient({
+            teamId: typeof typedInput.teamId === "string" ? typedInput.teamId : undefined,
+        });
+        try {
+            const result = await client.addReaction({
+                channel: String(typedInput.channel ?? ""),
+                timestamp: String(typedInput.timestamp ?? ""),
+                name: String(typedInput.name ?? ""),
+            });
+            return {
+                success: true,
+                message: `Added :${typedInput.name}: reaction in ${result.channelId}.`,
+                data: result,
+            };
+        }
+        catch (error) {
+            return {
+                success: false,
+                message: error instanceof Error ? error.message : "Slack reaction failed.",
+            };
+        }
+        finally {
+            await client.close();
+        }
+    },
+};
+export const SLACK_TOOL_DEFINITIONS = [
+    check_slack_messages,
+    send_slack_message,
+    react_slack_message,
+];
+//# sourceMappingURL=slack.js.map

package/dist/definitions/slack.js.map

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

package/dist/definitions/web.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Web tool definitions
+ *
+ * Tools: web_search, web_fetch, browse (3 tools)
+ */
+import type { Tool } from "../types.js";
+/** Web tool definitions (3) */
+export declare const WEB_TOOL_DEFINITIONS: Tool[];
+//# sourceMappingURL=web.d.ts.map

package/dist/definitions/web.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"web.d.ts","sourceRoot":"","sources":["../../src/definitions/web.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,aAAa,CAAC;AA8GxC,+BAA+B;AAC/B,eAAO,MAAM,oBAAoB,EAAE,IAAI,EAAoC,CAAC"}

package/dist/definitions/web.js

@@ -0,0 +1,110 @@
+/**
+ * Web tool definitions
+ *
+ * Tools: web_search, web_fetch, browse (3 tools)
+ */
+import { executeWebSearch, executeWebFetch, executeBrowse } from "../executors/index.js";
+// web_search uses SearchProviderRouter with automatic provider selection
+const web_search = {
+    name: "web_search",
+    description: "Search the web for information. Auto-selects the best available search provider (Brave, Firecrawl, Exa, Tavily, Jina, or DuckDuckGo). Works without any API key via Jina/DuckDuckGo fallback. Set ARIA_SEARCH_PROVIDER to override.",
+    category: "web",
+    parameters: {
+        type: "object",
+        properties: {
+            query: { type: "string", description: "Search query" },
+            limit: {
+                type: "number",
+                description: "Maximum number of results",
+                default: 10,
+            },
+            domains: {
+                type: "array",
+                items: { type: "string" },
+                description: "Only include results from these domains",
+            },
+            excludeDomains: {
+                type: "array",
+                items: { type: "string" },
+                description: "Exclude results from these domains",
+            },
+            topic: {
+                type: "string",
+                enum: ["general", "news"],
+                description: "Search topic classification",
+            },
+            timeRange: {
+                type: "string",
+                enum: ["day", "week", "month", "year"],
+                description: "Restrict results to a recent time window",
+            },
+        },
+        required: ["query"],
+    },
+    riskLevel: "moderate",
+    isReadOnly: true,
+    loadingTier: "always",
+    execute: executeWebSearch,
+};
+const web_fetch = {
+    name: "web_fetch",
+    description: "Fetch the content of a web page. Returns the page content as text or structured data.",
+    category: "web",
+    parameters: {
+        type: "object",
+        properties: {
+            url: { type: "string", description: "URL to fetch" },
+            format: {
+                type: "string",
+                enum: ["text", "html", "json"],
+                description: "Output format",
+                default: "text",
+            },
+            headers: {
+                type: "object",
+                description: "Custom request headers",
+                additionalProperties: { type: "string" },
+            },
+            timeoutMs: {
+                type: "number",
+                description: "Request timeout in milliseconds",
+                default: 30_000,
+            },
+            maxSizeBytes: {
+                type: "number",
+                description: "Maximum response body size in bytes",
+                default: 1 * 1024 * 1024,
+            },
+        },
+        required: ["url"],
+    },
+    riskLevel: "safe",
+    isReadOnly: true,
+    loadingTier: "always",
+    execute: executeWebFetch,
+};
+// browse uses Readability + Turndown for structured markdown extraction
+const browse = {
+    name: "browse",
+    description: "Browse a web page and extract structured markdown content using Readability + Turndown. Returns the page title and markdown (up to 50K chars). Handles GitHub URL normalization and retry with backoff.",
+    category: "web",
+    parameters: {
+        type: "object",
+        properties: {
+            url: { type: "string", description: "URL to browse" },
+            timeoutMs: {
+                type: "number",
+                description: "Request timeout in milliseconds",
+                default: 30_000,
+            },
+        },
+        required: ["url"],
+    },
+    riskLevel: "safe",
+    isReadOnly: true,
+    loadingTier: "always",
+    execute: executeBrowse,
+};
+/** Web tool definitions (3) */
+export const WEB_TOOL_DEFINITIONS = [web_search, web_fetch, browse];
+//# sourceMappingURL=web.js.map

package/dist/definitions/web.js.map

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

package/dist/executors/apply-patch.d.ts

@@ -0,0 +1,52 @@
+/**
+ * @aria/tools - Apply Patch executor
+ *
+ * Parses and applies unified diff patches with:
+ * - Path traversal protection (SECURITY-CRITICAL)
+ * - Atomic writes (all-or-nothing application)
+ * - Fuzzy hunk matching (offset tolerance)
+ * - CRLF normalization
+ */
+import type { ToolContext, ToolResult } from "../types.js";
+export interface ApplyPatchInput {
+    /** Unified diff format patch content */
+    patch: string;
+    /** Working directory for relative paths in the patch */
+    cwd?: string;
+}
+/** A single hunk within a file diff */
+interface Hunk {
+    /** Original file start line (1-based) */
+    oldStart: number;
+    /** Number of lines in original */
+    oldCount: number;
+    /** Modified file start line (1-based) */
+    newStart: number;
+    /** Number of lines in modified */
+    newCount: number;
+    /** Lines in the hunk: each prefixed with ' ', '+', or '-' */
+    lines: string[];
+}
+/** A diff for a single file */
+interface FileDiff {
+    /** Original file path (null for new files) */
+    oldPath: string | null;
+    /** Modified file path (null for deleted files) */
+    newPath: string | null;
+    /** Hunks to apply */
+    hunks: Hunk[];
+}
+/**
+ * Parse a unified diff string into an array of file diffs.
+ * Handles standard unified diff and git-style diffs.
+ */
+export declare function parseUnifiedDiff(patch: string): FileDiff[];
+/**
+ * Execute the apply_patch tool.
+ *
+ * Parses a unified diff, validates all paths for security,
+ * and applies changes atomically.
+ */
+export declare function executeApplyPatch(input: ApplyPatchInput, ctx: ToolContext): Promise<ToolResult>;
+export {};
+//# sourceMappingURL=apply-patch.d.ts.map

package/dist/executors/apply-patch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"apply-patch.d.ts","sourceRoot":"","sources":["../../src/executors/apply-patch.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAMH,OAAO,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAO3D,MAAM,WAAW,eAAe;IAC9B,wCAAwC;IACxC,KAAK,EAAE,MAAM,CAAC;IACd,wDAAwD;IACxD,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,uCAAuC;AACvC,UAAU,IAAI;IACZ,yCAAyC;IACzC,QAAQ,EAAE,MAAM,CAAC;IACjB,kCAAkC;IAClC,QAAQ,EAAE,MAAM,CAAC;IACjB,yCAAyC;IACzC,QAAQ,EAAE,MAAM,CAAC;IACjB,kCAAkC;IAClC,QAAQ,EAAE,MAAM,CAAC;IACjB,6DAA6D;IAC7D,KAAK,EAAE,MAAM,EAAE,CAAC;CACjB;AAED,+BAA+B;AAC/B,UAAU,QAAQ;IAChB,8CAA8C;IAC9C,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,kDAAkD;IAClD,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,qBAAqB;IACrB,KAAK,EAAE,IAAI,EAAE,CAAC;CACf;AAoCD;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,QAAQ,EAAE,CAsG1D;AAiuBD;;;;;GAKG;AACH,wBAAsB,iBAAiB,CACrC,KAAK,EAAE,eAAe,EACtB,GAAG,EAAE,WAAW,GACf,OAAO,CAAC,UAAU,CAAC,CA4ErB"}