@aria-cli/tools 1.0.18 → 1.0.31

package/dist/definitions/browser/pw-shared.d.ts

@@ -1,22 +0,0 @@
-/**
- * Shared utilities for Playwright-based browser tool functions.
- * Ported from OpenClaw's pw-tools-core.shared.ts.
- */
-/**
- * Parse a raw ref string into its canonical "eN" form.
- * Accepts: "e1", "@e1", "ref=e1" -> "e1". Returns null if invalid.
- */
-export declare function parseRoleRef(raw: string): string | null;
-/**
- * Validate and normalize a ref string. Throws if the ref is empty/invalid.
- */
-export declare function requireRef(value: unknown): string;
-/**
- * Clamp a timeout value to a safe range (500ms .. 120s).
- */
-export declare function normalizeTimeoutMs(timeoutMs: number | undefined, fallback: number): number;
-/**
- * Rewrite Playwright errors into messages that guide the LLM to take
- * corrective action (re-snapshot, scroll, etc.).
- */
-export declare function toAIFriendlyError(error: unknown, selector: string): Error;

package/dist/definitions/browser/pw-snapshot.d.ts

@@ -1,34 +0,0 @@
-/**
- * Accessibility tree snapshot and role-ref system.
- * Ported from OpenClaw's pw-role-snapshot.ts + pw-tools-core.snapshot.ts.
- */
-import type { PwPage, RoleRefMap, RoleSnapshotStats, SnapshotResult } from "./types.js";
-export interface RoleSnapshotOptions {
-    /** Only include interactive elements (buttons, links, inputs, etc.). */
-    interactive?: boolean;
-    /** Maximum depth to include (0 = root only). */
-    maxDepth?: number;
-    /** Remove unnamed structural elements and empty branches. */
-    compact?: boolean;
-}
-export declare function getRoleSnapshotStats(snapshot: string, refs: RoleRefMap): RoleSnapshotStats;
-/**
- * Build a role-ref snapshot from Playwright's ariaSnapshot() output.
- * This is the core transform: raw ARIA tree text -> annotated tree + ref map.
- */
-export declare function buildRoleSnapshotFromAriaSnapshot(ariaSnapshot: string, options?: RoleSnapshotOptions): {
-    snapshot: string;
-    refs: RoleRefMap;
-};
-/**
- * Take a role-based accessibility snapshot of a page.
- * Uses Playwright's built-in ariaSnapshot() on the :root locator,
- * then annotates elements with [ref=eN] markers.
- */
-export declare function snapshotPage(page: PwPage, options?: RoleSnapshotOptions): Promise<SnapshotResult>;
-/**
- * Navigate a page to a URL.
- */
-export declare function navigatePage(page: PwPage, url: string, timeoutMs?: number): Promise<{
-    url: string;
-}>;

package/dist/definitions/browser/pw-state.d.ts

@@ -1,22 +0,0 @@
-/**
- * Cookie and storage management.
- * Ported from OpenClaw's pw-tools-core.state.ts + pw-tools-core.storage.ts.
- */
-import type { PwBrowserContext, PwCookie, PwPage } from "./types.js";
-export declare function cookiesGet(context: PwBrowserContext): Promise<{
-    cookies: PwCookie[];
-}>;
-export declare function cookiesSet(context: PwBrowserContext, cookies: Array<{
-    name: string;
-    value: string;
-    domain: string;
-    path?: string;
-}>): Promise<void>;
-export declare function cookiesClear(context: PwBrowserContext): Promise<void>;
-type StorageKind = "local" | "session";
-export declare function storageGet(page: PwPage, kind: StorageKind, key?: string): Promise<{
-    values: Record<string, string>;
-}>;
-export declare function storageSet(page: PwPage, kind: StorageKind, key: string, value: string): Promise<void>;
-export declare function storageClear(page: PwPage, kind: StorageKind): Promise<void>;
-export {};

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

@@ -1,277 +0,0 @@
-/**
- * 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/definitions/code-intelligence.d.ts

@@ -1,8 +0,0 @@
-/**
- * Code intelligence tool definitions
- *
- * 7 native tools wrapping external CLI binaries for code search, structural
- * analysis, knowledge graphs, LSP intelligence, and file discovery.
- */
-import type { Tool } from "../types.js";
-export declare const CODE_INTELLIGENCE_TOOL_DEFINITIONS: Tool[];

package/dist/definitions/core.d.ts

@@ -1,47 +0,0 @@
-/**
- * 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";
-export { FRG_TOOL_DEFINITIONS } from "./frg.js";
-export { CODE_INTELLIGENCE_TOOL_DEFINITIONS } from "./code-intelligence.js";
-export { SEARCH_TOOL_DEFINITIONS } from "./search.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/definitions/delegation.d.ts

@@ -1,11 +0,0 @@
-/**
- * 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[];

package/dist/definitions/deploy.d.ts

@@ -1,15 +0,0 @@
-/**
- * Deploy tool definition.
- *
- * Tools: deploy (1 tool)
- *
- * Deploys ARIA to a remote machine via SSH. Detects OS, installs Node.js + pnpm,
- * clones/syncs repo, builds, sets up TLS certs, configures firewall, writes config,
- * and starts the daemon.
- *
- * Safety: requires explicit user confirmation (dangerous risk level).
- * Auto-denied in daemon autorun mode.
- */
-import type { Tool } from "../types.js";
-/** Deploy tool definitions (1) */
-export declare const DEPLOY_TOOL_DEFINITIONS: Tool[];

package/dist/definitions/filesystem.d.ts

@@ -1,9 +0,0 @@
-/**
- * Filesystem tool definitions
- *
- * Tools: read_file, write_file, edit_file, glob, ls, apply_patch (6 tools)
- * Note: grep replaced by native indexed search in SEARCH_TOOL_DEFINITIONS
- */
-import type { Tool } from "../types.js";
-/** Filesystem tool definitions (6) — grep replaced by native indexed search in SEARCH_TOOL_DEFINITIONS */
-export declare const FILESYSTEM_TOOL_DEFINITIONS: Tool[];

package/dist/definitions/frg.d.ts

@@ -1,3 +0,0 @@
-import type { Tool } from "../types.js";
-export declare const frgTool: Tool;
-export declare const FRG_TOOL_DEFINITIONS: Tool[];

package/dist/definitions/index.d.ts

@@ -1,19 +0,0 @@
-/**
- * Tool definitions exports
- */
-export { CORE_TOOL_DEFINITIONS, getCoreTools, getCoreTool, getCoreToolsByCategory, getCoreToolsByRiskLevel, } from "./core.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 { QUIP_TOOL_DEFINITIONS } from "./quip.js";
-export { NETWORK_TOOL_DEFINITIONS } from "./network.js";
-export { META_TOOL_DEFINITIONS } from "./meta.js";
-export { SESSION_HISTORY_TOOL_DEFINITIONS } from "./session-history.js";
-export { FRG_TOOL_DEFINITIONS } from "./frg.js";
-export { CODE_INTELLIGENCE_TOOL_DEFINITIONS } from "./code-intelligence.js";
-export { SEARCH_TOOL_DEFINITIONS } from "./search.js";

package/dist/definitions/memory.d.ts

@@ -1,8 +0,0 @@
-/**
- * Memory tool definitions
- *
- * Tools: remember, recall, forget, recall_knowledge, reflect (5 tools)
- */
-import type { Tool } from "../types.js";
-/** Memory tool definitions (5) */
-export declare const MEMORY_TOOL_DEFINITIONS: Tool[];

package/dist/definitions/messaging.d.ts

@@ -1,11 +0,0 @@
-/**
- * Messaging tool definitions
- *
- * Tools: send_message, check_messages, search_messages, get_thread (4 tools)
- *
- * Inter-agent messaging for arions, workers, and leaders.
- * All tools use context.messageStore (injected by runner when Memoria is available).
- * When the message store isn't wired, tools return a clear error.
- */
-/** Messaging tool definitions (4) */
-export declare const MESSAGING_TOOL_DEFINITIONS: import("../types.js").Tool[];

package/dist/definitions/meta.d.ts

@@ -1,11 +0,0 @@
-/**
- * Meta tool definitions
- *
- * Tools:
- * - ask_user, quest_update, quest_list
- * - search, learn_tool, learn_skill
- * - create_tool, create_skill, use_skill
- */
-import type { Tool } from "../types.js";
-/** Meta tool definitions */
-export declare const META_TOOL_DEFINITIONS: Tool[];

package/dist/definitions/network.d.ts

@@ -1,11 +0,0 @@
-/**
- * Network management tool definitions.
- *
- * Tools: manage_network, list_clients (2 tools)
- *
- * ARIA manages its own secure WireGuard network. The LLM uses this tool
- * to invite peers, revoke access, list connections, and check status.
- * No user configuration needed — the network auto-creates on first run.
- */
-/** Network tool definitions (2) */
-export declare const NETWORK_TOOL_DEFINITIONS: import("../types.js").Tool[];

package/dist/definitions/outlook.d.ts

@@ -1,2 +0,0 @@
-import type { Tool } from "../types.js";
-export declare const OUTLOOK_TOOL_DEFINITIONS: Tool[];

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

@@ -1,11 +0,0 @@
-import type { Tool } from "../../types.js";
-import type { ApplyPatchSummary } from "./patch-parser.js";
-export type ApplyPatchResult = {
-    success: boolean;
-    summary: ApplyPatchSummary;
-    text: string;
-};
-export declare function applyPatch(input: string, options: {
-    cwd: string;
-}): Promise<ApplyPatchResult>;
-export declare const applyPatchTool: Tool;

package/dist/definitions/patch/fuzzy-match.d.ts

@@ -1,10 +0,0 @@
-type UpdateFileChunk = {
-    changeContext?: string;
-    oldLines: string[];
-    newLines: string[];
-    isEndOfFile: boolean;
-};
-export declare function applyUpdateHunk(filePath: string, chunks: UpdateFileChunk[], options?: {
-    readFile?: (filePath: string) => Promise<string>;
-}): Promise<string>;
-export {};

package/dist/definitions/patch/index.d.ts

@@ -1 +0,0 @@
-export { applyPatchTool } from "./apply-patch.js";

package/dist/definitions/patch/patch-parser.d.ts

@@ -1,50 +0,0 @@
-export declare const BEGIN_PATCH_MARKER = "*** Begin Patch";
-export declare const END_PATCH_MARKER = "*** End Patch";
-export declare const ADD_FILE_MARKER = "*** Add File: ";
-export declare const DELETE_FILE_MARKER = "*** Delete File: ";
-export declare const UPDATE_FILE_MARKER = "*** Update File: ";
-export declare const MOVE_TO_MARKER = "*** Move to: ";
-export declare const EOF_MARKER = "*** End of File";
-export declare const CHANGE_CONTEXT_MARKER = "@@ ";
-export declare const EMPTY_CHANGE_CONTEXT_MARKER = "@@";
-export type AddFileHunk = {
-    kind: "add";
-    path: string;
-    contents: string;
-};
-export type DeleteFileHunk = {
-    kind: "delete";
-    path: string;
-};
-export type UpdateFileChunk = {
-    changeContext?: string;
-    oldLines: string[];
-    newLines: string[];
-    isEndOfFile: boolean;
-};
-export type UpdateFileHunk = {
-    kind: "update";
-    path: string;
-    movePath?: string;
-    chunks: UpdateFileChunk[];
-};
-export type Hunk = AddFileHunk | DeleteFileHunk | UpdateFileHunk;
-export type ApplyPatchSummary = {
-    added: string[];
-    modified: string[];
-    deleted: string[];
-};
-export declare function normalizeUnicodeSpaces(value: string): string;
-export declare function parsePatchText(input: string): {
-    hunks: Hunk[];
-    patch: string;
-};
-export declare function checkPatchBoundariesLenient(lines: string[]): string[];
-export declare function parseOneHunk(lines: string[], lineNumber: number): {
-    hunk: Hunk;
-    consumed: number;
-};
-export declare function parseUpdateFileChunk(lines: string[], lineNumber: number, allowMissingContext: boolean): {
-    chunk: UpdateFileChunk;
-    consumed: number;
-};

package/dist/definitions/patch/sandbox-paths.d.ts

@@ -1,18 +0,0 @@
-export declare function resolveSandboxInputPath(filePath: string, cwd: string): string;
-export declare function resolveSandboxPath(params: {
-    filePath: string;
-    cwd: string;
-    root: string;
-}): {
-    resolved: string;
-    relative: string;
-};
-export declare function assertSandboxPath(params: {
-    filePath: string;
-    cwd: string;
-    root: string;
-    allowFinalSymlink?: boolean;
-}): Promise<{
-    resolved: string;
-    relative: string;
-}>;

package/dist/definitions/process/index.d.ts

@@ -1 +0,0 @@
-export { processTool } from "./process.js";