@aria-cli/tools 1.0.18 → 1.0.31

package/dist/.aria-build-stamp.json

@@ -1,4 +1,4 @@
 {
   "label": "@aria-cli/tools",
-  "fingerprint": "23dd7ad113ef94286fb8ad12906576774b7d6544029c6f279d39ec891e747245"
+  "fingerprint": "74abf51d8b1333013be9b0e0d3c9444ebcf52a461719ca0c7ca8084fc0038d54"
 }

package/dist/ask-user-interaction.js

@@ -0,0 +1,23 @@
+const ASK_USER_PAUSE_REQUIRED_CODE = "ASK_USER_PAUSE_REQUIRED";
+export class AskUserPauseRequiredError extends Error {
+    code = ASK_USER_PAUSE_REQUIRED_CODE;
+    questions;
+    constructor(questions, message = "ask_user requires additional answers before this run can continue.") {
+        super(message);
+        this.name = "AskUserPauseRequiredError";
+        this.questions = questions.map((question) => ({
+            question: question.question,
+            ...(Array.isArray(question.options) ? { options: [...question.options] } : {}),
+        }));
+    }
+}
+export function isAskUserPauseRequiredError(error) {
+    if (error instanceof AskUserPauseRequiredError)
+        return true;
+    if (!error || typeof error !== "object")
+        return false;
+    const candidate = error;
+    return (candidate.code === ASK_USER_PAUSE_REQUIRED_CODE ||
+        (candidate.name === "AskUserPauseRequiredError" && Array.isArray(candidate.questions)));
+}
+//# sourceMappingURL=ask-user-interaction.js.map

package/dist/cache/web-cache.js

@@ -0,0 +1,67 @@
+export class WebCache {
+    maxEntries;
+    ttlMs;
+    cache = new Map();
+    setCallCount = 0;
+    /** How often to run proactive eviction (every N set() calls) */
+    static EVICTION_INTERVAL = 100;
+    constructor(maxEntries = 100, ttlMs = 15 * 60 * 1000) {
+        this.maxEntries = maxEntries;
+        this.ttlMs = ttlMs;
+    }
+    get(key) {
+        const entry = this.cache.get(key);
+        if (!entry || Date.now() > entry.expiresAt) {
+            if (entry)
+                this.cache.delete(key);
+            return undefined;
+        }
+        // Touch for true LRU semantics (recently read becomes most-recent)
+        this.cache.delete(key);
+        this.cache.set(key, entry);
+        return entry.value;
+    }
+    set(key, value) {
+        // Update-in-place should also refresh recency
+        if (this.cache.has(key)) {
+            this.cache.delete(key);
+        }
+        // Proactive eviction: sweep expired entries periodically to prevent memory bloat
+        this.setCallCount++;
+        if (this.setCallCount % WebCache.EVICTION_INTERVAL === 0) {
+            this.evictExpired();
+        }
+        if (this.cache.size >= this.maxEntries) {
+            // Evict least recently used (oldest key in Map iteration order)
+            const lruKey = this.cache.keys().next().value;
+            if (lruKey)
+                this.cache.delete(lruKey);
+        }
+        this.cache.set(key, { value, expiresAt: Date.now() + this.ttlMs });
+    }
+    /**
+     * Proactively remove all expired entries from the cache.
+     * Called periodically from set() to prevent expired entries from
+     * consuming memory until they are accessed or evicted by LRU.
+     */
+    evictExpired() {
+        const now = Date.now();
+        for (const [key, entry] of this.cache) {
+            if (entry.expiresAt <= now) {
+                this.cache.delete(key);
+            }
+        }
+    }
+    /** Remove all entries from the cache */
+    clear() {
+        this.cache.clear();
+    }
+    /** Current number of entries in the cache */
+    get size() {
+        return this.cache.size;
+    }
+}
+export const searchCache = new WebCache(100);
+export const fetchCache = new WebCache(50);
+export const browseCache = new WebCache(50);
+//# sourceMappingURL=web-cache.js.map

package/dist/definitions/arion.js

@@ -0,0 +1,105 @@
+/**
+ * Arion tool definitions
+ *
+ * Tools: hatch_arion, rest_arion, wake_arion, retire_arion (4 tools)
+ */
+import { executeHatchArion, executeRestArion, executeWakeArion, executeRetireArion, } from "../executors/index.js";
+const hatch_arion = {
+    name: "hatch_arion",
+    description: "Create a new arion persona with specified personality, traits, and beliefs. Requires user confirmation.",
+    category: "arion",
+    parameters: {
+        type: "object",
+        properties: {
+            name: { type: "string", description: "The arion's unique name" },
+            emoji: { type: "string", description: "Visual emoji identifier" },
+            traits: {
+                type: "array",
+                items: { type: "string" },
+                description: "Core personality traits",
+            },
+            style: {
+                type: "string",
+                enum: ["formal", "casual", "technical", "friendly"],
+                description: "Communication style",
+            },
+            beliefs: {
+                type: "array",
+                items: { type: "string" },
+                description: "Core beliefs to seed into memory",
+            },
+            background: { type: "string", description: "Brief backstory or context" },
+            quirks: {
+                type: "array",
+                items: { type: "string" },
+                description: "Unique behavioral quirks",
+            },
+            strengths: {
+                type: "array",
+                items: { type: "string" },
+                description: "Areas of particular strength",
+            },
+        },
+        required: ["name", "traits", "style"],
+    },
+    riskLevel: "dangerous",
+    requiresConfirmation: true,
+    isReadOnly: false,
+    loadingTier: "always",
+    execute: executeHatchArion,
+};
+const rest_arion = {
+    name: "rest_arion",
+    description: "Put an arion persona to rest. Triggers deep memory consolidation before resting.",
+    category: "arion",
+    parameters: {
+        type: "object",
+        properties: {
+            name: { type: "string", description: "Name of the arion to rest" },
+        },
+        required: ["name"],
+    },
+    riskLevel: "moderate",
+    isReadOnly: false,
+    loadingTier: "always",
+    execute: executeRestArion,
+};
+const wake_arion = {
+    name: "wake_arion",
+    description: "Wake a resting arion persona, making it available for use.",
+    category: "arion",
+    parameters: {
+        type: "object",
+        properties: {
+            name: {
+                type: "string",
+                description: "Name of the resting arion to wake",
+            },
+        },
+        required: ["name"],
+    },
+    riskLevel: "moderate",
+    isReadOnly: false,
+    loadingTier: "always",
+    execute: executeWakeArion,
+};
+const retire_arion = {
+    name: "retire_arion",
+    description: "Permanently retire an arion persona. This action cannot be undone.",
+    category: "arion",
+    parameters: {
+        type: "object",
+        properties: {
+            name: { type: "string", description: "Name of the arion to retire" },
+        },
+        required: ["name"],
+    },
+    riskLevel: "dangerous",
+    requiresConfirmation: true,
+    isReadOnly: false,
+    loadingTier: "always",
+    execute: executeRetireArion,
+};
+/** Arion tool definitions (4) */
+export const ARION_TOOL_DEFINITIONS = [hatch_arion, rest_arion, wake_arion, retire_arion];
+//# sourceMappingURL=arion.js.map

package/dist/definitions/browser/browser.js

@@ -0,0 +1,419 @@
+// 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
+import { launchBrowser, closeBrowser, getSession, getRefs, setRefs, getConsoleMessages, getNetworkRequests, listTabs, newTab, selectTab, closeTab, } from "./pw-session.js";
+import { snapshotPage, navigatePage } from "./pw-snapshot.js";
+import { clickViaPlaywright, hoverViaPlaywright, dragViaPlaywright, typeViaPlaywright, selectOptionViaPlaywright, pressKeyViaPlaywright, evaluateViaPlaywright, takeScreenshot, scrollPage, waitForCondition, uploadFiles, } from "./pw-interactions.js";
+import { cookiesGet, cookiesSet, cookiesClear } from "./pw-state.js";
+import { filterConsoleMessages, filterNetworkRequests, formatConsoleMessages, formatNetworkRequests, } from "./pw-responses.js";
+// ── JSON Schema for the action parameter ──────────────────────────────
+const browserParameterSchema = {
+    type: "object",
+    properties: {
+        action: {
+            type: "string",
+            enum: [
+                "launch",
+                "close",
+                "navigate",
+                "snapshot",
+                "click",
+                "type",
+                "hover",
+                "drag",
+                "select_option",
+                "press_key",
+                "scroll",
+                "evaluate",
+                "screenshot",
+                "get_console",
+                "get_network",
+                "wait",
+                "tab_list",
+                "tab_new",
+                "tab_select",
+                "tab_close",
+                "cookies_get",
+                "cookies_set",
+                "cookies_clear",
+                "upload",
+            ],
+            description: "The browser action to perform. 'launch' is optional; actions auto-start a session when needed. Use 'snapshot' to read page content, refs like [e1] with 'click'/'type'.",
+        },
+        // launch
+        url: { type: "string", description: "URL to navigate to (for launch/navigate/tab_new)" },
+        headless: {
+            type: "boolean",
+            description: "Run browser without visible window (default: true)",
+        },
+        // snapshot
+        interactive: {
+            type: "boolean",
+            description: "Only show interactive elements in snapshot (buttons, links, inputs)",
+        },
+        // click/type/hover/drag/select_option/upload
+        ref: {
+            type: "string",
+            description: "Element ref from snapshot (e.g. 'e1', 'e5')",
+        },
+        text: { type: "string", description: "Text to type (for 'type' action)" },
+        submit: {
+            type: "boolean",
+            description: "Press Enter after typing (for 'type' action)",
+        },
+        slowly: {
+            type: "boolean",
+            description: "Type character by character instead of filling (for 'type' action)",
+        },
+        button: {
+            type: "string",
+            enum: ["left", "right", "middle"],
+            description: "Mouse button (for 'click' action)",
+        },
+        modifiers: {
+            type: "array",
+            items: { type: "string" },
+            description: "Keyboard modifiers (for 'click': Alt, Control, Meta, Shift)",
+        },
+        doubleClick: {
+            type: "boolean",
+            description: "Double-click instead of single click",
+        },
+        startRef: {
+            type: "string",
+            description: "Source element ref (for 'drag' action)",
+        },
+        endRef: {
+            type: "string",
+            description: "Target element ref (for 'drag' action)",
+        },
+        values: {
+            type: "array",
+            items: { type: "string" },
+            description: "Values to select (for 'select_option' action)",
+        },
+        // press_key
+        key: {
+            type: "string",
+            description: "Key to press (for 'press_key': Enter, Tab, Escape, ArrowDown, etc.)",
+        },
+        // scroll
+        direction: {
+            type: "string",
+            enum: ["up", "down"],
+            description: "Scroll direction",
+        },
+        amount: {
+            type: "number",
+            description: "Scroll amount in pixels (default: 500)",
+        },
+        // evaluate
+        script: {
+            type: "string",
+            description: "JavaScript to evaluate in browser context (for 'evaluate' action)",
+        },
+        // get_console
+        level: {
+            type: "string",
+            description: "Minimum console level filter (debug/info/warning/error)",
+        },
+        // get_network
+        filter: {
+            type: "string",
+            description: "URL substring filter for network requests",
+        },
+        // wait
+        selector: {
+            type: "string",
+            description: "CSS selector to wait for (for 'wait' action)",
+        },
+        timeout: {
+            type: "number",
+            description: "Timeout in milliseconds (for 'wait' action)",
+        },
+        // tab_select
+        index: {
+            type: "number",
+            description: "Tab index (for 'tab_select'/'tab_close')",
+        },
+        // cookies_set
+        cookies: {
+            type: "array",
+            items: {
+                type: "object",
+                properties: {
+                    name: { type: "string" },
+                    value: { type: "string" },
+                    domain: { type: "string" },
+                    path: { type: "string" },
+                },
+                required: ["name", "value", "domain"],
+            },
+            description: "Cookies to set (for 'cookies_set' action)",
+        },
+        // upload
+        paths: {
+            type: "array",
+            items: { type: "string" },
+            description: "File paths to upload (for 'upload' action)",
+        },
+    },
+    required: ["action"],
+};
+// ── Helpers ───────────────────────────────────────────────────────────
+function ok(message, data) {
+    return { success: true, message, data };
+}
+function fail(message) {
+    return { success: false, message };
+}
+async function requireSession() {
+    const session = getSession();
+    if (session) {
+        return session;
+    }
+    return launchBrowser();
+}
+// ── Action dispatcher ─────────────────────────────────────────────────
+async function executeBrowserAction(input) {
+    const action = input;
+    try {
+        switch (action.action) {
+            // ── Lifecycle ─────────────────────────────────────────────────
+            case "launch": {
+                const session = await launchBrowser({
+                    headless: action.headless,
+                    url: action.url,
+                });
+                const url = session.page.url();
+                return ok(`Browser launched.${action.url ? ` Navigated to ${url}` : ""}\nUse 'snapshot' to see page content.`, { url });
+            }
+            case "close": {
+                await closeBrowser();
+                return ok("Browser closed.");
+            }
+            // ── Navigation ────────────────────────────────────────────────
+            case "navigate": {
+                const session = await requireSession();
+                const result = await navigatePage(session.page, action.url);
+                setRefs({}); // Refs are stale after navigation
+                return ok(`Navigated to ${result.url}. Use 'snapshot' to see page content.`, result);
+            }
+            // ── Snapshot ──────────────────────────────────────────────────
+            case "snapshot": {
+                const session = await requireSession();
+                const result = await snapshotPage(session.page, {
+                    interactive: action.interactive,
+                });
+                setRefs(result.refs);
+                const header = `Page: ${result.title}\nURL: ${result.url}\n` +
+                    `Elements: ${result.stats.refs} total, ${result.stats.interactive} interactive\n\n`;
+                return ok(header + result.snapshot, {
+                    url: result.url,
+                    title: result.title,
+                    stats: result.stats,
+                });
+            }
+            // ── Click ─────────────────────────────────────────────────────
+            case "click": {
+                const session = await requireSession();
+                await clickViaPlaywright({
+                    page: session.page,
+                    refs: getRefs(),
+                    ref: action.ref,
+                    doubleClick: action.doubleClick,
+                    button: action.button,
+                    modifiers: action.modifiers,
+                });
+                return ok(`Clicked ${action.ref}. Use 'snapshot' to see updated page.`);
+            }
+            // ── Type ──────────────────────────────────────────────────────
+            case "type": {
+                const session = await requireSession();
+                await typeViaPlaywright({
+                    page: session.page,
+                    refs: getRefs(),
+                    ref: action.ref,
+                    text: action.text,
+                    submit: action.submit,
+                    slowly: action.slowly,
+                });
+                return ok(`Typed "${action.text.length > 50 ? action.text.slice(0, 50) + "..." : action.text}" into ${action.ref}.${action.submit ? " Submitted with Enter." : ""}`);
+            }
+            // ── Hover ─────────────────────────────────────────────────────
+            case "hover": {
+                const session = await requireSession();
+                await hoverViaPlaywright({
+                    page: session.page,
+                    refs: getRefs(),
+                    ref: action.ref,
+                });
+                return ok(`Hovered over ${action.ref}.`);
+            }
+            // ── Drag ──────────────────────────────────────────────────────
+            case "drag": {
+                const session = await requireSession();
+                await dragViaPlaywright({
+                    page: session.page,
+                    refs: getRefs(),
+                    startRef: action.startRef,
+                    endRef: action.endRef,
+                });
+                return ok(`Dragged ${action.startRef} to ${action.endRef}.`);
+            }
+            // ── Select option ─────────────────────────────────────────────
+            case "select_option": {
+                const session = await requireSession();
+                await selectOptionViaPlaywright({
+                    page: session.page,
+                    refs: getRefs(),
+                    ref: action.ref,
+                    values: action.values,
+                });
+                return ok(`Selected [${action.values.join(", ")}] in ${action.ref}.`);
+            }
+            // ── Key press ─────────────────────────────────────────────────
+            case "press_key": {
+                const session = await requireSession();
+                await pressKeyViaPlaywright({
+                    page: session.page,
+                    key: action.key,
+                });
+                return ok(`Pressed key: ${action.key}`);
+            }
+            // ── Scroll ────────────────────────────────────────────────────
+            case "scroll": {
+                const session = await requireSession();
+                await scrollPage({
+                    page: session.page,
+                    direction: action.direction,
+                    amount: action.amount,
+                });
+                return ok(`Scrolled ${action.direction} ${action.amount ?? 500}px. Use 'snapshot' to see updated content.`);
+            }
+            // ── Evaluate ──────────────────────────────────────────────────
+            case "evaluate": {
+                const session = await requireSession();
+                const result = await evaluateViaPlaywright({
+                    page: session.page,
+                    script: action.script,
+                });
+                const output = result === undefined
+                    ? "undefined"
+                    : typeof result === "string"
+                        ? result
+                        : JSON.stringify(result, null, 2);
+                return ok(output, { result });
+            }
+            // ── Screenshot ────────────────────────────────────────────────
+            case "screenshot": {
+                const session = await requireSession();
+                const buffer = await takeScreenshot({ page: session.page });
+                const base64 = buffer.toString("base64");
+                return ok(`Screenshot taken (${buffer.length} bytes, base64-encoded).`, {
+                    base64,
+                    mimeType: "image/png",
+                });
+            }
+            // ── Console ───────────────────────────────────────────────────
+            case "get_console": {
+                await requireSession();
+                const messages = filterConsoleMessages(getConsoleMessages(), action.level);
+                return ok(formatConsoleMessages(messages), { count: messages.length });
+            }
+            // ── Network ───────────────────────────────────────────────────
+            case "get_network": {
+                await requireSession();
+                const requests = filterNetworkRequests(getNetworkRequests(), action.filter);
+                return ok(formatNetworkRequests(requests), { count: requests.length });
+            }
+            // ── Wait ──────────────────────────────────────────────────────
+            case "wait": {
+                const session = await requireSession();
+                await waitForCondition({
+                    page: session.page,
+                    selector: action.selector,
+                    text: action.text,
+                    timeout: action.timeout,
+                });
+                return ok("Wait condition satisfied. Use 'snapshot' to see current page.");
+            }
+            // ── Tab management ────────────────────────────────────────────
+            case "tab_list": {
+                const tabs = listTabs();
+                const desc = tabs
+                    .map((t) => `[${t.index}]${t.active ? " (active)" : ""} ${t.url}`)
+                    .join("\n");
+                return ok(desc || "No tabs open.", { tabs });
+            }
+            case "tab_new": {
+                const result = await newTab(action.url);
+                return ok(`Opened new tab [${result.index}]: ${result.url}`, result);
+            }
+            case "tab_select": {
+                await requireSession();
+                const result = await selectTab(action.index);
+                return ok(`Switched to tab ${action.index}: ${result.url}`, result);
+            }
+            case "tab_close": {
+                await closeTab(action.index);
+                return ok(`Tab closed.${action.index !== undefined ? ` (index ${action.index})` : ""}`);
+            }
+            // ── Cookies ───────────────────────────────────────────────────
+            case "cookies_get": {
+                const session = await requireSession();
+                const result = await cookiesGet(session.context);
+                const desc = result.cookies.length
+                    ? result.cookies.map((c) => `${c.name}=${c.value} (${c.domain})`).join("\n")
+                    : "No cookies.";
+                return ok(desc, result);
+            }
+            case "cookies_set": {
+                const session = await requireSession();
+                await cookiesSet(session.context, action.cookies);
+                return ok(`Set ${action.cookies.length} cookie(s).`);
+            }
+            case "cookies_clear": {
+                const session = await requireSession();
+                await cookiesClear(session.context);
+                return ok("All cookies cleared.");
+            }
+            // ── Upload ────────────────────────────────────────────────────
+            case "upload": {
+                const session = await requireSession();
+                await uploadFiles({
+                    page: session.page,
+                    refs: getRefs(),
+                    ref: action.ref,
+                    paths: action.paths,
+                });
+                return ok(`Uploaded ${action.paths.length} file(s) to ${action.ref}.`);
+            }
+            default: {
+                const exhaustive = action;
+                return fail(`Unknown browser action: ${exhaustive.action}`);
+            }
+        }
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        return fail(message);
+    }
+}
+// ── Tool definition ───────────────────────────────────────────────────
+export const browserTool = {
+    name: "browser",
+    description: "Control a web browser via Playwright. Supports navigation, clicking, typing, taking snapshots of page content, and more. " +
+        "Actions auto-start a browser session; use 'launch' only when you want explicit startup control. Use 'snapshot' to see the current page state as an accessibility tree with element refs like [e1], [e2]. " +
+        "Use those refs with 'click', 'type', 'hover', etc. to interact with elements. " +
+        "Use 'evaluate' to run JavaScript in the page context. Use 'screenshot' to capture the page visually.",
+    category: "web",
+    parameters: browserParameterSchema,
+    riskLevel: "moderate",
+    isReadOnly: false,
+    loadingTier: "always",
+    async execute(input, _context) {
+        return executeBrowserAction(input);
+    },
+};
+//# sourceMappingURL=browser.js.map

package/dist/definitions/browser/index.js

@@ -0,0 +1,5 @@
+// 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
+export { browserTool } from "./browser.js";
+//# sourceMappingURL=index.js.map