@aria-cli/tools 1.0.19 → 1.0.31

package/dist/utils/retry.d.ts

@@ -1,11 +0,0 @@
-export interface RetryOptions {
-    maxAttempts?: number;
-    baseDelayMs?: number;
-    maxDelayMs?: number;
-    retryableStatuses?: number[];
-    retryableCodes?: string[];
-    /** Custom fetch function for per-attempt wrappers (e.g., DNS pinning). */
-    fetchFn?: (url: string, init: RequestInit) => Promise<Response>;
-}
-export declare function fetchWithRetry(url: string, init: RequestInit, options?: RetryOptions): Promise<Response>;
-export declare function fetchWithSsrf(url: string, init: RequestInit, retryOptions?: RetryOptions): Promise<Response>;

package/dist/utils/safe-parse-json.d.ts

@@ -1,26 +0,0 @@
-/**
- * Safe JSON extraction and parsing utilities for LLM output.
- *
- * Handles code fences, preamble text, bare JSON, and validates against Zod schemas.
- * NEVER throws -- always returns a typed Result.
- */
-import type { ZodType } from "zod";
-export type JsonParseResult<T> = {
-    ok: true;
-    data: T;
-} | {
-    ok: false;
-    reason: "no_json" | "parse_error" | "schema_mismatch";
-    raw: string;
-};
-/**
- * Extract JSON substring from LLM output.
- * Returns the first candidate found by robust balanced scanning.
- */
-export declare function extractJson(raw: string): string | null;
-/**
- * Safely extract and parse JSON from LLM output with Zod validation.
- * Handles code fences, preamble text, bare JSON.
- * NEVER throws -- always returns a typed Result.
- */
-export declare function safeParseJson<T>(raw: string, schema: ZodType<T>): JsonParseResult<T>;

package/dist/utils/url.d.ts

@@ -1,10 +0,0 @@
-/**
- * Convert GitHub blob URLs to raw.githubusercontent.com URLs.
- * GitHub blob URLs return HTML wrappers; raw URLs return actual file content.
- */
-export declare function normalizeGitHubUrl(url: string): string;
-/**
- * Get configurable User-Agent string.
- * Reads from ARIA_USER_AGENT env var, falls back to default.
- */
-export declare function getUserAgent(): string;

package/dist-cjs/ask-user-interaction.d.ts

@@ -1,10 +0,0 @@
-export interface AskUserQuestion {
-    question: string;
-    options?: string[];
-}
-export declare class AskUserPauseRequiredError extends Error {
-    readonly code: "ASK_USER_PAUSE_REQUIRED";
-    readonly questions: AskUserQuestion[];
-    constructor(questions: AskUserQuestion[], message?: string);
-}
-export declare function isAskUserPauseRequiredError(error: unknown): error is AskUserPauseRequiredError;

package/dist-cjs/cache/web-cache.d.ts

@@ -1,52 +0,0 @@
-export declare class WebCache<T> {
-    private maxEntries;
-    private ttlMs;
-    private cache;
-    private setCallCount;
-    /** How often to run proactive eviction (every N set() calls) */
-    private static readonly EVICTION_INTERVAL;
-    constructor(maxEntries?: number, ttlMs?: number);
-    get(key: string): T | undefined;
-    set(key: string, value: T): void;
-    /**
-     * 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(): void;
-    /** Remove all entries from the cache */
-    clear(): void;
-    /** Current number of entries in the cache */
-    get size(): number;
-}
-import type { SearchResult } from "../providers/search-provider.js";
-/** Cached search output: query + results array */
-export interface CachedSearchOutput {
-    query: string;
-    results: SearchResult[];
-}
-/** Cached fetch output with metadata */
-export interface CachedFetchOutput {
-    content: unknown;
-    status: number;
-    contentType?: string;
-    fromCache: boolean;
-    fetchedAt: string;
-    finalUrl: string;
-    contentBytes: number;
-    truncated: boolean;
-}
-/** Cached browse output with metadata */
-export interface CachedBrowseOutput {
-    url: string;
-    title: string;
-    content: string;
-    fromCache: boolean;
-    fetchedAt: string;
-    finalUrl: string;
-    contentBytes: number;
-    truncated: boolean;
-}
-export declare const searchCache: WebCache<CachedSearchOutput>;
-export declare const fetchCache: WebCache<CachedFetchOutput>;
-export declare const browseCache: WebCache<CachedBrowseOutput>;

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

@@ -1,8 +0,0 @@
-/**
- * Arion tool definitions
- *
- * Tools: hatch_arion, rest_arion, wake_arion, retire_arion (4 tools)
- */
-import type { Tool } from "../types.js";
-/** Arion tool definitions (4) */
-export declare const ARION_TOOL_DEFINITIONS: Tool[];

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

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

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

@@ -1 +0,0 @@
-export { browserTool } from "./browser.js";

package/dist-cjs/definitions/browser/pw-downloads.d.ts

@@ -1,13 +0,0 @@
-import type { PwPage } from "./types.js";
-/**
- * Wait for the next download event on the page and save the file.
- */
-export declare function waitForDownload(opts: {
-    page: PwPage;
-    path?: string;
-    timeoutMs?: number;
-}): Promise<{
-    url: string;
-    suggestedFilename: string;
-    path: string;
-}>;

package/dist-cjs/definitions/browser/pw-interactions.d.ts

@@ -1,78 +0,0 @@
-/**
- * Playwright interaction handlers: click, type, hover, drag, select, key press, evaluate.
- * Ported from OpenClaw's pw-tools-core.interactions.ts.
- */
-import type { PwPage, RoleRefMap } from "./types.js";
-/**
- * Resolve a ref string (e.g. "e1") into a Playwright Locator using the
- * role-ref map from the last snapshot.
- */
-export declare function refLocator(page: PwPage, ref: string, refs: RoleRefMap): import("./types.js").PwLocator;
-export declare function clickViaPlaywright(opts: {
-    page: PwPage;
-    refs: RoleRefMap;
-    ref: string;
-    doubleClick?: boolean;
-    button?: "left" | "right" | "middle";
-    modifiers?: string[];
-    timeoutMs?: number;
-}): Promise<void>;
-export declare function hoverViaPlaywright(opts: {
-    page: PwPage;
-    refs: RoleRefMap;
-    ref: string;
-    timeoutMs?: number;
-}): Promise<void>;
-export declare function dragViaPlaywright(opts: {
-    page: PwPage;
-    refs: RoleRefMap;
-    startRef: string;
-    endRef: string;
-    timeoutMs?: number;
-}): Promise<void>;
-export declare function typeViaPlaywright(opts: {
-    page: PwPage;
-    refs: RoleRefMap;
-    ref: string;
-    text: string;
-    submit?: boolean;
-    slowly?: boolean;
-    timeoutMs?: number;
-}): Promise<void>;
-export declare function selectOptionViaPlaywright(opts: {
-    page: PwPage;
-    refs: RoleRefMap;
-    ref: string;
-    values: string[];
-    timeoutMs?: number;
-}): Promise<void>;
-export declare function pressKeyViaPlaywright(opts: {
-    page: PwPage;
-    key: string;
-}): Promise<void>;
-export declare function evaluateViaPlaywright(opts: {
-    page: PwPage;
-    script: string;
-    timeoutMs?: number;
-}): Promise<unknown>;
-export declare function takeScreenshot(opts: {
-    page: PwPage;
-    fullPage?: boolean;
-}): Promise<Buffer>;
-export declare function scrollPage(opts: {
-    page: PwPage;
-    direction: "up" | "down";
-    amount?: number;
-}): Promise<void>;
-export declare function waitForCondition(opts: {
-    page: PwPage;
-    selector?: string;
-    text?: string;
-    timeout?: number;
-}): Promise<void>;
-export declare function uploadFiles(opts: {
-    page: PwPage;
-    refs: RoleRefMap;
-    ref: string;
-    paths: string[];
-}): Promise<void>;

package/dist-cjs/definitions/browser/pw-responses.d.ts

@@ -1,28 +0,0 @@
-/**
- * Console, network, and error monitoring.
- * Ported from OpenClaw's pw-tools-core.activity.ts + pw-tools-core.responses.ts.
- */
-import type { BrowserConsoleMessage, BrowserNetworkRequest, BrowserPageError } from "./types.js";
-export declare const MAX_CONSOLE_MESSAGES = 500;
-export declare const MAX_NETWORK_REQUESTS = 500;
-export declare const MAX_PAGE_ERRORS = 200;
-/**
- * Filter console messages by minimum severity level.
- */
-export declare function filterConsoleMessages(messages: BrowserConsoleMessage[], level?: string): BrowserConsoleMessage[];
-/**
- * Filter network requests by URL substring match.
- */
-export declare function filterNetworkRequests(requests: BrowserNetworkRequest[], filter?: string): BrowserNetworkRequest[];
-/**
- * Format console messages for tool output.
- */
-export declare function formatConsoleMessages(messages: BrowserConsoleMessage[]): string;
-/**
- * Format network requests for tool output.
- */
-export declare function formatNetworkRequests(requests: BrowserNetworkRequest[]): string;
-/**
- * Format page errors for tool output.
- */
-export declare function formatPageErrors(errors: BrowserPageError[]): string;

package/dist-cjs/definitions/browser/pw-session.d.ts

@@ -1,65 +0,0 @@
-/**
- * Browser session lifecycle management.
- * Unlike OpenClaw (which connects to an external Chrome via CDP), ARIA
- * launches its own Playwright browser instance directly.
- */
-import type { BrowserConsoleMessage, BrowserNetworkRequest, BrowserPageError, BrowserSession, PwBrowser, RoleRefMap } from "./types.js";
-export declare function getSession(): BrowserSession | null;
-export declare function getRefs(): RoleRefMap;
-export declare function setRefs(refs: RoleRefMap): void;
-export declare function getConsoleMessages(): BrowserConsoleMessage[];
-export declare function getNetworkRequests(): BrowserNetworkRequest[];
-export declare function getPageErrors(): BrowserPageError[];
-/**
- * Test seam for injecting a mocked playwright loader.
- * Passing null restores the production loader.
- */
-export declare function setPlaywrightLoaderForTest(loader: (() => Promise<unknown>) | null): void;
-type ChromiumLike = {
-    launch: (options?: {
-        headless?: boolean;
-    }) => Promise<PwBrowser>;
-};
-/**
- * Resolve Playwright's chromium launcher across module interop shapes.
- * Some runtimes expose `{ chromium }`, others only `{ default: { chromium } }`.
- */
-export declare function resolveChromiumLauncher(moduleValue: unknown): ChromiumLike;
-/**
- * Launch a new Playwright browser session.
- * Uses dynamic import so the tool module loads even without playwright installed.
- */
-export declare function launchBrowser(options?: {
-    headless?: boolean;
-    url?: string;
-}): Promise<BrowserSession>;
-/**
- * Close the current browser session and clean up all state.
- */
-export declare function closeBrowser(): Promise<void>;
-/**
- * List all open tabs (pages) in the current context.
- */
-export declare function listTabs(): Array<{
-    index: number;
-    url: string;
-    active: boolean;
-}>;
-/**
- * Open a new tab, optionally navigating to a URL.
- */
-export declare function newTab(url?: string): Promise<{
-    index: number;
-    url: string;
-}>;
-/**
- * Switch to a tab by index.
- */
-export declare function selectTab(index: number): Promise<{
-    url: string;
-}>;
-/**
- * Close a tab by index (defaults to current tab).
- */
-export declare function closeTab(index?: number): Promise<void>;
-export {};

package/dist-cjs/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-cjs/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-cjs/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-cjs/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-cjs/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[];