@aria-cli/tools 1.0.0

package/dist-cjs/definitions/browser/types.d.ts

@@ -0,0 +1,277 @@
+/**
+ * Shared browser tool types.
+ *
+ * Playwright types are referenced dynamically (the `playwright` package is an
+ * optional peer dependency loaded via `await import("playwright")`).
+ */
+/** Minimal Browser interface (matches Playwright's Browser). */
+export interface PwBrowser {
+    close(): Promise<void>;
+    contexts(): PwBrowserContext[];
+    isConnected(): boolean;
+}
+/** Minimal BrowserContext interface. */
+export interface PwBrowserContext {
+    pages(): PwPage[];
+    newPage(): Promise<PwPage>;
+    cookies(urls?: string | string[]): Promise<PwCookie[]>;
+    addCookies(cookies: PwCookie[]): Promise<void>;
+    clearCookies(): Promise<void>;
+    setOffline(offline: boolean): Promise<void>;
+    close(): Promise<void>;
+}
+/** Minimal Page interface. */
+export interface PwPage {
+    goto(url: string, options?: {
+        timeout?: number;
+        waitUntil?: "load" | "domcontentloaded" | "networkidle" | "commit";
+    }): Promise<unknown>;
+    url(): string;
+    title(): Promise<string>;
+    close(): Promise<void>;
+    content(): Promise<string>;
+    setViewportSize(size: {
+        width: number;
+        height: number;
+    }): Promise<void>;
+    screenshot(options?: {
+        type?: "png" | "jpeg";
+        fullPage?: boolean;
+    }): Promise<Buffer>;
+    evaluate<T>(fn: string | ((...args: unknown[]) => T), arg?: unknown): Promise<T>;
+    locator(selector: string): PwLocator;
+    getByRole(role: string, options?: {
+        name?: string;
+        exact?: boolean;
+    }): PwLocator;
+    keyboard: {
+        press(key: string, options?: {
+            delay?: number;
+        }): Promise<void>;
+    };
+    mouse: {
+        wheel(deltaX: number, deltaY: number): Promise<void>;
+    };
+    waitForTimeout(timeout: number): Promise<void>;
+    waitForSelector(selector: string, options?: {
+        timeout?: number;
+        state?: string;
+    }): Promise<unknown>;
+    waitForLoadState(state?: string, options?: {
+        timeout?: number;
+    }): Promise<void>;
+    on(event: string, handler: (...args: unknown[]) => void): void;
+    off(event: string, handler: (...args: unknown[]) => void): void;
+    isClosed(): boolean;
+    frameLocator(selector: string): PwFrameLocator;
+}
+export interface PwFrameLocator {
+    locator(selector: string): PwLocator;
+    getByRole(role: string, options?: {
+        name?: string;
+        exact?: boolean;
+    }): PwLocator;
+}
+export interface PwLocator {
+    click(options?: {
+        timeout?: number;
+        button?: string;
+        modifiers?: string[];
+    }): Promise<void>;
+    dblclick(options?: {
+        timeout?: number;
+        button?: string;
+        modifiers?: string[];
+    }): Promise<void>;
+    fill(value: string, options?: {
+        timeout?: number;
+    }): Promise<void>;
+    type(text: string, options?: {
+        timeout?: number;
+        delay?: number;
+    }): Promise<void>;
+    press(key: string, options?: {
+        timeout?: number;
+    }): Promise<void>;
+    hover(options?: {
+        timeout?: number;
+    }): Promise<void>;
+    selectOption(values: string | string[], options?: {
+        timeout?: number;
+    }): Promise<string[]>;
+    dragTo(target: PwLocator, options?: {
+        timeout?: number;
+    }): Promise<void>;
+    setInputFiles(files: string | string[]): Promise<void>;
+    highlight(): Promise<void>;
+    screenshot(options?: {
+        type?: "png" | "jpeg";
+    }): Promise<Buffer>;
+    scrollIntoViewIfNeeded(options?: {
+        timeout?: number;
+    }): Promise<void>;
+    boundingBox(): Promise<{
+        x: number;
+        y: number;
+        width: number;
+        height: number;
+    } | null>;
+    elementHandle(): Promise<PwElementHandle | null>;
+    nth(index: number): PwLocator;
+    first(): PwLocator;
+    waitFor(options?: {
+        state?: string;
+        timeout?: number;
+    }): Promise<void>;
+    ariaSnapshot(): Promise<string>;
+    setChecked(checked: boolean, options?: {
+        timeout?: number;
+    }): Promise<void>;
+}
+export interface PwElementHandle {
+    evaluate<T>(fn: (el: Element, ...args: unknown[]) => T, ...args: unknown[]): Promise<T>;
+}
+export interface PwCookie {
+    name: string;
+    value: string;
+    domain?: string;
+    path?: string;
+    url?: string;
+    expires?: number;
+    httpOnly?: boolean;
+    secure?: boolean;
+    sameSite?: "Lax" | "None" | "Strict";
+}
+export interface BrowserSession {
+    browser: PwBrowser;
+    context: PwBrowserContext;
+    page: PwPage;
+}
+export interface RoleRef {
+    role: string;
+    name?: string;
+    /** Index used only when role+name duplicates exist. */
+    nth?: number;
+}
+export type RoleRefMap = Record<string, RoleRef>;
+export interface RoleSnapshotStats {
+    lines: number;
+    chars: number;
+    refs: number;
+    interactive: number;
+}
+export interface SnapshotResult {
+    /** Text representation of accessibility tree */
+    snapshot: string;
+    refs: RoleRefMap;
+    stats: RoleSnapshotStats;
+    url: string;
+    title: string;
+}
+export interface BrowserConsoleMessage {
+    type: string;
+    text: string;
+    timestamp: string;
+}
+export interface BrowserNetworkRequest {
+    id: string;
+    timestamp: string;
+    method: string;
+    url: string;
+    status?: number;
+    resourceType?: string;
+    ok?: boolean;
+    failureText?: string;
+}
+export interface BrowserPageError {
+    message: string;
+    name?: string;
+    timestamp: string;
+}
+export type BrowserAction = {
+    action: "launch";
+    url?: string;
+    headless?: boolean;
+} | {
+    action: "close";
+} | {
+    action: "navigate";
+    url: string;
+} | {
+    action: "snapshot";
+    interactive?: boolean;
+} | {
+    action: "click";
+    ref: string;
+    button?: "left" | "right" | "middle";
+    modifiers?: string[];
+    doubleClick?: boolean;
+} | {
+    action: "type";
+    ref: string;
+    text: string;
+    submit?: boolean;
+    slowly?: boolean;
+} | {
+    action: "hover";
+    ref: string;
+} | {
+    action: "drag";
+    startRef: string;
+    endRef: string;
+} | {
+    action: "select_option";
+    ref: string;
+    values: string[];
+} | {
+    action: "press_key";
+    key: string;
+} | {
+    action: "scroll";
+    direction: "up" | "down";
+    amount?: number;
+} | {
+    action: "evaluate";
+    script: string;
+} | {
+    action: "screenshot";
+} | {
+    action: "get_console";
+    level?: string;
+} | {
+    action: "get_network";
+    filter?: string;
+} | {
+    action: "wait";
+    selector?: string;
+    text?: string;
+    timeout?: number;
+} | {
+    action: "tab_list";
+} | {
+    action: "tab_new";
+    url?: string;
+} | {
+    action: "tab_select";
+    index: number;
+} | {
+    action: "tab_close";
+    index?: number;
+} | {
+    action: "cookies_get";
+    url?: string;
+} | {
+    action: "cookies_set";
+    cookies: Array<{
+        name: string;
+        value: string;
+        domain: string;
+        path?: string;
+    }>;
+} | {
+    action: "cookies_clear";
+} | {
+    action: "upload";
+    ref: string;
+    paths: string[];
+};

package/dist-cjs/definitions/browser/types.js

@@ -0,0 +1,6 @@
+"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 });
+//# sourceMappingURL=types.js.map

package/dist-cjs/definitions/browser/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/definitions/browser/types.ts"],"names":[],"mappings":";AAAA,2EAA2E;AAC3E,uCAAuC;AACvC,gFAAgF"}

package/dist-cjs/definitions/core.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Core tool definitions for ARIA
+ * Core tools across 10 definition groups:
+ * memory (5), web (3+1), filesystem (8), shell (7+1), arion (4), delegation (3), messaging (4+2), network (2), deploy (1), meta (11)
+ *
+ * Individual category definitions are in their respective files.
+ * This module assembles them into the unified CORE_TOOL_DEFINITIONS array.
+ * browser and process are forked from OpenClaw (MIT) and added directly here.
+ */
+import type { Tool, ToolCategory, RiskLevel } from "../types.js";
+export { MEMORY_TOOL_DEFINITIONS } from "./memory.js";
+export { WEB_TOOL_DEFINITIONS } from "./web.js";
+export { FILESYSTEM_TOOL_DEFINITIONS } from "./filesystem.js";
+export { SHELL_TOOL_DEFINITIONS } from "./shell.js";
+export { ARION_TOOL_DEFINITIONS } from "./arion.js";
+export { DELEGATION_TOOL_DEFINITIONS } from "./delegation.js";
+export { MESSAGING_TOOL_DEFINITIONS } from "./messaging.js";
+export { SLACK_TOOL_DEFINITIONS } from "./slack.js";
+export { OUTLOOK_TOOL_DEFINITIONS } from "./outlook.js";
+export { QUIP_TOOL_DEFINITIONS } from "./quip.js";
+export { NETWORK_TOOL_DEFINITIONS } from "./network.js";
+export { DEPLOY_TOOL_DEFINITIONS } from "./deploy.js";
+export { META_TOOL_DEFINITIONS } from "./meta.js";
+export { SESSION_HISTORY_TOOL_DEFINITIONS } from "./session-history.js";
+/**
+ * All core tool definitions
+ */
+export declare const CORE_TOOL_DEFINITIONS: Tool[];
+/**
+ * Get all core tools
+ */
+export declare function getCoreTools(): Tool[];
+/**
+ * Get a core tool by name
+ */
+export declare function getCoreTool(name: string): Tool | undefined;
+/**
+ * Get all tools in a category
+ */
+export declare function getCoreToolsByCategory(category: ToolCategory): Tool[];
+/**
+ * Get all tools by risk level
+ */
+export declare function getCoreToolsByRiskLevel(riskLevel: RiskLevel): Tool[];

package/dist-cjs/definitions/core.js

@@ -0,0 +1,119 @@
+"use strict";
+/**
+ * Core tool definitions for ARIA
+ * Core tools across 10 definition groups:
+ * memory (5), web (3+1), filesystem (8), shell (7+1), arion (4), delegation (3), messaging (4+2), network (2), deploy (1), meta (11)
+ *
+ * Individual category definitions are in their respective files.
+ * This module assembles them into the unified CORE_TOOL_DEFINITIONS array.
+ * browser and process are forked from OpenClaw (MIT) and added directly here.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CORE_TOOL_DEFINITIONS = exports.SESSION_HISTORY_TOOL_DEFINITIONS = exports.META_TOOL_DEFINITIONS = exports.DEPLOY_TOOL_DEFINITIONS = exports.NETWORK_TOOL_DEFINITIONS = exports.QUIP_TOOL_DEFINITIONS = exports.OUTLOOK_TOOL_DEFINITIONS = exports.SLACK_TOOL_DEFINITIONS = exports.MESSAGING_TOOL_DEFINITIONS = exports.DELEGATION_TOOL_DEFINITIONS = exports.ARION_TOOL_DEFINITIONS = exports.SHELL_TOOL_DEFINITIONS = exports.FILESYSTEM_TOOL_DEFINITIONS = exports.WEB_TOOL_DEFINITIONS = exports.MEMORY_TOOL_DEFINITIONS = void 0;
+exports.getCoreTools = getCoreTools;
+exports.getCoreTool = getCoreTool;
+exports.getCoreToolsByCategory = getCoreToolsByCategory;
+exports.getCoreToolsByRiskLevel = getCoreToolsByRiskLevel;
+const memory_js_1 = require("./memory.js");
+const web_js_1 = require("./web.js");
+const filesystem_js_1 = require("./filesystem.js");
+const shell_js_1 = require("./shell.js");
+const arion_js_1 = require("./arion.js");
+const delegation_js_1 = require("./delegation.js");
+const messaging_js_1 = require("./messaging.js");
+const slack_js_1 = require("./slack.js");
+const outlook_js_1 = require("./outlook.js");
+const quip_js_1 = require("./quip.js");
+const network_js_1 = require("./network.js");
+const deploy_js_1 = require("./deploy.js");
+const meta_js_1 = require("./meta.js");
+const session_history_js_1 = require("./session-history.js");
+// OpenClaw forks (MIT) — Playwright browser automation and background process management
+const index_js_1 = require("./browser/index.js");
+const index_js_2 = require("./process/index.js");
+// Re-export category arrays for direct access
+var memory_js_2 = require("./memory.js");
+Object.defineProperty(exports, "MEMORY_TOOL_DEFINITIONS", { enumerable: true, get: function () { return memory_js_2.MEMORY_TOOL_DEFINITIONS; } });
+var web_js_2 = require("./web.js");
+Object.defineProperty(exports, "WEB_TOOL_DEFINITIONS", { enumerable: true, get: function () { return web_js_2.WEB_TOOL_DEFINITIONS; } });
+var filesystem_js_2 = require("./filesystem.js");
+Object.defineProperty(exports, "FILESYSTEM_TOOL_DEFINITIONS", { enumerable: true, get: function () { return filesystem_js_2.FILESYSTEM_TOOL_DEFINITIONS; } });
+var shell_js_2 = require("./shell.js");
+Object.defineProperty(exports, "SHELL_TOOL_DEFINITIONS", { enumerable: true, get: function () { return shell_js_2.SHELL_TOOL_DEFINITIONS; } });
+var arion_js_2 = require("./arion.js");
+Object.defineProperty(exports, "ARION_TOOL_DEFINITIONS", { enumerable: true, get: function () { return arion_js_2.ARION_TOOL_DEFINITIONS; } });
+var delegation_js_2 = require("./delegation.js");
+Object.defineProperty(exports, "DELEGATION_TOOL_DEFINITIONS", { enumerable: true, get: function () { return delegation_js_2.DELEGATION_TOOL_DEFINITIONS; } });
+var messaging_js_2 = require("./messaging.js");
+Object.defineProperty(exports, "MESSAGING_TOOL_DEFINITIONS", { enumerable: true, get: function () { return messaging_js_2.MESSAGING_TOOL_DEFINITIONS; } });
+var slack_js_2 = require("./slack.js");
+Object.defineProperty(exports, "SLACK_TOOL_DEFINITIONS", { enumerable: true, get: function () { return slack_js_2.SLACK_TOOL_DEFINITIONS; } });
+var outlook_js_2 = require("./outlook.js");
+Object.defineProperty(exports, "OUTLOOK_TOOL_DEFINITIONS", { enumerable: true, get: function () { return outlook_js_2.OUTLOOK_TOOL_DEFINITIONS; } });
+var quip_js_2 = require("./quip.js");
+Object.defineProperty(exports, "QUIP_TOOL_DEFINITIONS", { enumerable: true, get: function () { return quip_js_2.QUIP_TOOL_DEFINITIONS; } });
+var network_js_2 = require("./network.js");
+Object.defineProperty(exports, "NETWORK_TOOL_DEFINITIONS", { enumerable: true, get: function () { return network_js_2.NETWORK_TOOL_DEFINITIONS; } });
+var deploy_js_2 = require("./deploy.js");
+Object.defineProperty(exports, "DEPLOY_TOOL_DEFINITIONS", { enumerable: true, get: function () { return deploy_js_2.DEPLOY_TOOL_DEFINITIONS; } });
+var meta_js_2 = require("./meta.js");
+Object.defineProperty(exports, "META_TOOL_DEFINITIONS", { enumerable: true, get: function () { return meta_js_2.META_TOOL_DEFINITIONS; } });
+var session_history_js_2 = require("./session-history.js");
+Object.defineProperty(exports, "SESSION_HISTORY_TOOL_DEFINITIONS", { enumerable: true, get: function () { return session_history_js_2.SESSION_HISTORY_TOOL_DEFINITIONS; } });
+/**
+ * All core tool definitions
+ */
+exports.CORE_TOOL_DEFINITIONS = [
+    // Memory tools (5)
+    ...memory_js_1.MEMORY_TOOL_DEFINITIONS,
+    // Web tools (3 + browser)
+    ...web_js_1.WEB_TOOL_DEFINITIONS,
+    index_js_1.browserTool,
+    // Filesystem tools (8, includes forked apply_patch with fuzzy matching)
+    ...filesystem_js_1.FILESYSTEM_TOOL_DEFINITIONS,
+    // Shell tools (7 + process)
+    ...shell_js_1.SHELL_TOOL_DEFINITIONS,
+    index_js_2.processTool,
+    // Arion tools (4)
+    ...arion_js_1.ARION_TOOL_DEFINITIONS,
+    // Delegation tools (7): delegate_arion, spawn_worker, check_delegation, pause_delegation, resume_delegation, delegate_remote, quest_report
+    ...delegation_js_1.DELEGATION_TOOL_DEFINITIONS,
+    // Messaging tools (6): send_message, check_messages, search_messages, get_thread, check_slack_messages, send_slack_message
+    ...messaging_js_1.MESSAGING_TOOL_DEFINITIONS,
+    ...slack_js_1.SLACK_TOOL_DEFINITIONS,
+    ...outlook_js_1.OUTLOOK_TOOL_DEFINITIONS,
+    ...quip_js_1.QUIP_TOOL_DEFINITIONS,
+    // Network tools (2): manage_network + list_clients
+    ...network_js_1.NETWORK_TOOL_DEFINITIONS,
+    // Deploy tools (1): deploy (SSH remote deployment)
+    ...deploy_js_1.DEPLOY_TOOL_DEFINITIONS,
+    // Meta tools (10): ask_user/quest plus learning/meta capability tools
+    ...meta_js_1.META_TOOL_DEFINITIONS,
+    // Session History tools (1): session_history (list/search/get/current/stats/delete/set_title)
+    ...session_history_js_1.SESSION_HISTORY_TOOL_DEFINITIONS,
+];
+/**
+ * Get all core tools
+ */
+function getCoreTools() {
+    return exports.CORE_TOOL_DEFINITIONS;
+}
+/**
+ * Get a core tool by name
+ */
+function getCoreTool(name) {
+    return exports.CORE_TOOL_DEFINITIONS.find((tool) => tool.name === name);
+}
+/**
+ * Get all tools in a category
+ */
+function getCoreToolsByCategory(category) {
+    return exports.CORE_TOOL_DEFINITIONS.filter((tool) => tool.category === category);
+}
+/**
+ * Get all tools by risk level
+ */
+function getCoreToolsByRiskLevel(riskLevel) {
+    return exports.CORE_TOOL_DEFINITIONS.filter((tool) => tool.riskLevel === riskLevel);
+}
+//# sourceMappingURL=core.js.map

package/dist-cjs/definitions/core.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"core.js","sourceRoot":"","sources":["../../src/definitions/core.ts"],"names":[],"mappings":";AAAA;;;;;;;;GAQG;;;AA0EH,oCAEC;AAKD,kCAEC;AAKD,wDAEC;AAKD,0DAEC;AA9FD,2CAAsD;AACtD,qCAAgD;AAChD,mDAA8D;AAC9D,yCAAoD;AACpD,yCAAoD;AACpD,mDAA8D;AAC9D,iDAA4D;AAC5D,yCAAoD;AACpD,6CAAwD;AACxD,uCAAkD;AAClD,6CAAwD;AACxD,2CAAsD;AACtD,uCAAkD;AAClD,6DAAwE;AAExE,yFAAyF;AACzF,iDAAiD;AACjD,iDAAiD;AAEjD,8CAA8C;AAC9C,yCAAsD;AAA7C,oHAAA,uBAAuB,OAAA;AAChC,mCAAgD;AAAvC,8GAAA,oBAAoB,OAAA;AAC7B,iDAA8D;AAArD,4HAAA,2BAA2B,OAAA;AACpC,uCAAoD;AAA3C,kHAAA,sBAAsB,OAAA;AAC/B,uCAAoD;AAA3C,kHAAA,sBAAsB,OAAA;AAC/B,iDAA8D;AAArD,4HAAA,2BAA2B,OAAA;AACpC,+CAA4D;AAAnD,0HAAA,0BAA0B,OAAA;AACnC,uCAAoD;AAA3C,kHAAA,sBAAsB,OAAA;AAC/B,2CAAwD;AAA/C,sHAAA,wBAAwB,OAAA;AACjC,qCAAkD;AAAzC,gHAAA,qBAAqB,OAAA;AAC9B,2CAAwD;AAA/C,sHAAA,wBAAwB,OAAA;AACjC,yCAAsD;AAA7C,oHAAA,uBAAuB,OAAA;AAChC,qCAAkD;AAAzC,gHAAA,qBAAqB,OAAA;AAC9B,2DAAwE;AAA/D,sIAAA,gCAAgC,OAAA;AAEzC;;GAEG;AACU,QAAA,qBAAqB,GAAW;IAC3C,mBAAmB;IACnB,GAAG,mCAAuB;IAC1B,0BAA0B;IAC1B,GAAG,6BAAoB;IACvB,sBAAW;IACX,wEAAwE;IACxE,GAAG,2CAA2B;IAC9B,4BAA4B;IAC5B,GAAG,iCAAsB;IACzB,sBAAW;IACX,kBAAkB;IAClB,GAAG,iCAAsB;IACzB,2IAA2I;IAC3I,GAAG,2CAA2B;IAC9B,2HAA2H;IAC3H,GAAG,yCAA0B;IAC7B,GAAG,iCAAsB;IACzB,GAAG,qCAAwB;IAC3B,GAAG,+BAAqB;IACxB,mDAAmD;IACnD,GAAG,qCAAwB;IAC3B,mDAAmD;IACnD,GAAG,mCAAuB;IAC1B,sEAAsE;IACtE,GAAG,+BAAqB;IACxB,8FAA8F;IAC9F,GAAG,qDAAgC;CACpC,CAAC;AAEF;;GAEG;AACH,SAAgB,YAAY;IAC1B,OAAO,6BAAqB,CAAC;AAC/B,CAAC;AAED;;GAEG;AACH,SAAgB,WAAW,CAAC,IAAY;IACtC,OAAO,6BAAqB,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC;AAClE,CAAC;AAED;;GAEG;AACH,SAAgB,sBAAsB,CAAC,QAAsB;IAC3D,OAAO,6BAAqB,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,QAAQ,KAAK,QAAQ,CAAC,CAAC;AAC5E,CAAC;AAED;;GAEG;AACH,SAAgB,uBAAuB,CAAC,SAAoB;IAC1D,OAAO,6BAAqB,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,SAAS,KAAK,SAAS,CAAC,CAAC;AAC9E,CAAC"}

package/dist-cjs/definitions/delegation.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Delegation tool definitions
+ *
+ * Tools: delegate_arion, spawn_worker, check_delegation, pause_delegation, resume_delegation, delegate_remote, quest_report (7 tools)
+ *
+ * delegate_arion and spawn_worker call context.delegationExecutor (injected by runner).
+ * check_delegation uses context.delegationRegistry for status queries.
+ * When the executor/registry aren't wired, tools return a clear error.
+ */
+/** Delegation tool definitions (7) */
+export declare const DELEGATION_TOOL_DEFINITIONS: import("../types.js").Tool[];