@aria-cli/tools 1.0.19 → 1.0.33

package/dist/executors/meta.d.ts

@@ -1,73 +0,0 @@
-/**
- * @aria/tools - Meta tool executors
- *
- * Implementation of meta operations for ARIA tool system:
- * - ask_user: Interactive user prompting with rate limiting
- * - quest_update: Create/update quests persisted via QuestStore
- * - quest_list: List quests with status filtering
- */
-import type { ToolContext, ToolResult, QuestStoreStatus } from "../types.js";
-export interface AskUserInput {
-    questions: Array<{
-        question: string;
-        options?: string[];
-    }>;
-}
-/**
- * Reset the ask_user rate limit counter.
- * Should be called by the runner at the start of each turn.
- */
-export declare function resetAskUserCounter(): void;
-/**
- * Prompt the user with one or more questions.
- * Rate-limited to ASK_USER_MAX_CALLS per turn to prevent abuse loops.
- */
-export declare function executeAskUser(input: AskUserInput, ctx: ToolContext): Promise<ToolResult>;
-export interface QuestUpdateInput {
-    quests: Array<{
-        id?: string;
-        title?: string;
-        status?: QuestStoreStatus;
-        priority?: number;
-        blocked_by?: string;
-        notes?: string;
-    }>;
-}
-export interface QuestUpdateOutput {
-    quests: Array<{
-        id: string;
-        title: string;
-        status: string;
-        action: "created" | "updated" | "failed";
-        error?: string;
-    }>;
-}
-/**
- * Create or update quests, persisted via QuestStore (structured SQL storage).
- *
- * New quests get a nanoid-generated ID. Existing quests (with `id`) are updated
- * in-place via QuestStore.updateQuest().
- *
- * Each quest in the batch is processed independently — a failure on one quest
- * does not prevent others from being processed.
- */
-export declare function executeQuestUpdate(input: QuestUpdateInput, ctx: ToolContext): Promise<ToolResult>;
-export interface QuestListInput {
-    status?: "all" | QuestStoreStatus;
-}
-export interface QuestListOutput {
-    quests: Array<{
-        id: string;
-        title: string;
-        status: string;
-        priority: number;
-        blocked_by: string;
-        notes: string;
-        updatedAt: number;
-    }>;
-    count: number;
-}
-/**
- * List quests from QuestStore with optional status filtering.
- */
-export declare function executeQuestList(input: QuestListInput, ctx: ToolContext): Promise<ToolResult>;

package/dist/executors/process-registry.d.ts

@@ -1,98 +0,0 @@
-/**
- * @aria/tools - Spawned Process Registry
- *
- * Tracks PIDs of child processes spawned by shell executors.
- * Allows bulk cleanup (SIGTERM then SIGKILL) when a RunSession closes,
- * preventing orphaned processes from lingering.
- */
-export interface TrackedProcessMetadata {
-    command?: string;
-    args?: string[];
-    cwd?: string;
-    interactive?: boolean;
-}
-export interface ProcessExitMetadata {
-    exitCode?: number | null;
-    signal?: string | null;
-}
-export interface ProcessInfoSnapshot {
-    pid: number;
-    command: string | null;
-    args: string[];
-    cwd: string | null;
-    interactive: boolean;
-    startedAt: string;
-    runtimeMs: number;
-    status: "running" | "exited";
-    exitCode: number | null;
-    signal: string | null;
-    endedAt: string | null;
-}
-export interface ProcessWaitResult {
-    pid: number;
-    status: "running" | "exited" | "not_found";
-    timedOut: boolean;
-    process?: ProcessInfoSnapshot;
-}
-/**
- * Registry that tracks spawned child process PIDs.
- *
- * Usage:
- * - Shell executors call `add(pid)` after spawning a process
- * - Shell executors call `remove(pid)` when a process exits normally
- * - RunSession calls `killAll()` during close() to clean up orphans
- */
-export declare class SpawnedProcessRegistry {
-    private readonly active;
-    private readonly exited;
-    private readonly waiters;
-    private readonly reapers;
-    /**
-     * Register a spawned process PID.
-     */
-    add(pid: number, metadata?: TrackedProcessMetadata): void;
-    /**
-     * Deregister a process PID (e.g., after normal exit).
-     */
-    remove(pid: number, exit?: ProcessExitMetadata): void;
-    /**
-     * Check whether a PID is tracked.
-     */
-    has(pid: number): boolean;
-    recordExitMetadata(pid: number, exit?: ProcessExitMetadata): void;
-    /**
-     * Number of tracked PIDs.
-     */
-    get size(): number;
-    /**
-     * Return a snapshot of all tracked PIDs.
-     */
-    getAll(): number[];
-    /**
-     * Return process snapshots for observability.
-     */
-    listProcesses(options?: {
-        includeExited?: boolean;
-    }): ProcessInfoSnapshot[];
-    /**
-     * Return a single process snapshot by PID.
-     */
-    getProcess(pid: number): ProcessInfoSnapshot | undefined;
-    /**
-     * Wait for a tracked process to exit, up to timeoutMs.
-     */
-    waitForExit(pid: number, timeoutMs?: number): Promise<ProcessWaitResult>;
-    /**
-     * Send SIGTERM to all tracked PIDs, then SIGKILL after a timeout
-     * for any that are still alive. Clears the registry afterwards.
-     *
-     * Returns the list of PIDs that were signalled.
-     */
-    killAll(): Promise<number[]>;
-    private toRunningSnapshot;
-    private toExitedSnapshot;
-    private pruneExitedHistory;
-    private ensureReaper;
-    private clearReaper;
-    private reapIfExited;
-}

package/dist/executors/pty-session-store.d.ts

@@ -1,14 +0,0 @@
-/**
- * PTYSessionStore — manages PTY sessions for interactive process I/O.
- * Separate from SpawnedProcessRegistry (which is a PID-only cleanup safety net).
- */
-import type { PTYSession } from "./pty.js";
-export declare class PTYSessionStore {
-    private sessions;
-    add(pid: number, session: PTYSession): void;
-    get(pid: number): PTYSession | undefined;
-    has(pid: number): boolean;
-    remove(pid: number): void;
-    closeAll(): Promise<void>;
-    get size(): number;
-}

package/dist/executors/pty.d.ts

@@ -1,133 +0,0 @@
-/**
- * @aria/tools - PTY executor for interactive terminal programs
- *
- * Provides PTY (pseudo-terminal) support for running interactive programs
- * that require a terminal environment (like vim, less, etc.)
- */
-import * as nodePty from "node-pty";
-/**
- * Options for creating a PTY session.
- */
-export interface PTYOptions {
-    /** Command to execute */
-    command: string;
-    /** Arguments to pass to the command */
-    args?: string[];
-    /** Working directory */
-    cwd?: string;
-    /** Environment variables */
-    env?: Record<string, string>;
-    /** Terminal columns (default: 80) */
-    cols?: number;
-    /** Terminal rows (default: 24) */
-    rows?: number;
-}
-/**
- * Result of running a command in a PTY.
- */
-export interface PTYResult {
-    /** All output from the command */
-    output: string;
-    /** Exit code of the process */
-    exitCode: number;
-}
-/**
- * Error thrown when a PTY operation times out.
- */
-export declare class PTYTimeoutError extends Error {
-    readonly output: string;
-    constructor(message: string, output: string);
-}
-/**
- * Error thrown when a PTY operation fails.
- */
-export declare class PTYError extends Error {
-    readonly output?: string | undefined;
-    constructor(message: string, output?: string | undefined);
-}
-/**
- * A session wrapping a PTY process.
- * Provides methods for interacting with the process and collecting output.
- */
-export declare class PTYSession {
-    private static MAX_OUTPUT;
-    private _output;
-    private _isRunning;
-    private _exitCode;
-    private _exitPromise;
-    private _exitResolve;
-    private _pty;
-    private _dataDisposable;
-    private _exitDisposable;
-    constructor(pty: nodePty.IPty);
-    /**
-     * Write data to the terminal input.
-     */
-    write(data: string): void;
-    /**
-     * Resize the terminal.
-     */
-    resize(cols: number, rows: number): void;
-    /**
-     * Wait for a pattern to appear in the output.
-     * @param pattern String or RegExp to match
-     * @param timeoutMs Timeout in milliseconds (default: 5000)
-     * @returns The output accumulated up to and including the match
-     */
-    waitFor(pattern: string | RegExp, timeoutMs?: number): Promise<string>;
-    /**
-     * Wait for the process to exit.
-     * @param timeoutMs Timeout in milliseconds (default: 30000)
-     * @returns The complete output
-     */
-    waitForExit(timeoutMs?: number): Promise<string>;
-    /**
-     * Kill the process.
-     * @param signal Signal to send (default: SIGHUP on Unix)
-     */
-    kill(signal?: string): void;
-    /**
-     * Close the session and clean up resources.
-     */
-    close(): void;
-    /**
-     * Get the current output buffer.
-     */
-    get output(): string;
-    /**
-     * Check if the process is still running.
-     */
-    get isRunning(): boolean;
-    /**
-     * Get the process ID.
-     */
-    get pid(): number;
-    /**
-     * Get the exit code (undefined if still running).
-     */
-    get exitCode(): number | undefined;
-    /**
-     * Get the current terminal columns.
-     */
-    get cols(): number;
-    /**
-     * Get the current terminal rows.
-     */
-    get rows(): number;
-}
-/**
- * Create a new PTY session.
- * @param options Options for the PTY
- * @returns A PTYSession wrapping the process
- */
-export declare function createPTYSession(options: PTYOptions): Promise<PTYSession>;
-/**
- * Run a command in a PTY and wait for it to complete.
- * This is a convenience function for commands that don't require interaction.
- *
- * @param options Options for the PTY, with optional timeout
- * @returns The output and exit code
- */
-export declare function runInPTY(options: PTYOptions & {
-    timeoutMs?: number;
-}): Promise<PTYResult>;

package/dist/executors/restart.d.ts

@@ -1,13 +0,0 @@
-/**
- * @aria/tools - Restart executor
- *
- * Single restart path for both TUI and daemon:
- * Register an 'exit' handler to spawn a replacement process, then SIGINT
- * the current process for graceful shutdown. The replacement starts fresh
- * and goes through normal startup (heap check, createCliContext, REPL/daemon).
- */
-import type { ToolContext, ToolResult } from "../types.js";
-export interface RestartInput {
-    reason?: string;
-}
-export declare function executeRestart(input: RestartInput, ctx: ToolContext): Promise<ToolResult>;

package/dist/executors/search-freshness.d.ts

@@ -1,50 +0,0 @@
-/**
- * Freshness tracker for aria-search (code_search tool).
- *
- * Mirrors frg-freshness.ts patterns to close the freshness gaps:
- * 1. Tracks file mutations from ARIA tool writes (session overlay)
- * 2. Reconciles git-dirty files on each search
- * 3. Generates session overlay for the napi search() call
- *
- * The session overlay gives 0ms visibility for pending mutations —
- * files written by agents/users appear in search results immediately
- * without waiting for an index rebuild or hot.log sync.
- */
-export type SearchMutationOperation = "write" | "delete";
-export interface SearchMutationRecord {
-    path: string;
-    operation: SearchMutationOperation;
-    content?: string;
-    sequence: number;
-}
-export interface SearchSessionOverlay {
-    sessionWrites: Array<{
-        path: string;
-        content: string;
-    }>;
-    sessionDeletes: string[];
-}
-/**
- * Record a file mutation from an ARIA tool write/edit/delete.
- * Called alongside recordFrgMutation in filesystem.ts and apply-patch.ts.
- */
-export declare function recordSearchMutation(filePath: string, operation: SearchMutationOperation, content?: string): void;
-/**
- * Reconcile git-dirty files into the pending mutations map.
- * Runs `git diff --name-status -z HEAD` and `git ls-files -o --exclude-standard -z`
- * to detect files modified/created/deleted by external agents or the user.
- *
- * Throttled to at most once per GIT_RECONCILE_INTERVAL_MS to avoid
- * hammering git on rapid sequential searches.
- */
-export declare function reconcileSearchGitDirty(root: string): void;
-/**
- * Generate the session overlay for the napi search() call.
- * Reads content from disk for mutations without cached content.
- */
-export declare function getSearchSessionOverlay(root: string): SearchSessionOverlay;
-/**
- * Clear all pending mutations for a repo root.
- * Called after a full index rebuild (all mutations are now in the base index).
- */
-export declare function clearSearchMutations(root: string): void;

package/dist/executors/search-types.d.ts

@@ -1,52 +0,0 @@
-/**
- * Shared types and utilities for the unified search tool.
- *
- * Used by:
- * - Base executor in @aria/tools (learning-meta.ts)
- * - Runner wrapper in @aria/aria (search-wrapper.ts)
- * - Tests
- */
-/** Tagged search result — every result carries runnability info. */
-export interface SearchResult {
-    kind: "tool" | "skill" | "memory";
-    name: string;
-    description: string;
-    source: "memoria" | "local" | "local_cli" | "builtin" | "skills.sh" | "clawhub" | "npm" | "brew" | "web";
-    runnable: boolean;
-    action: "call" | "bash" | "read_skill" | "install" | "recall";
-    id?: string;
-    path?: string;
-    url?: string;
-    installCmd?: string;
-    installs?: number;
-    version?: string;
-    usageHint?: string;
-    /** Schema for injection (builtin source only, consumed by runner wrapper). */
-    _schema?: {
-        name: string;
-        description: string;
-        parameters?: unknown;
-    };
-}
-/** OS context for platform-aware search and result metadata. */
-export interface OSContext {
-    os: "macos" | "linux" | "windows";
-    arch: string;
-    distro?: string;
-}
-/** Input for the unified search tool. */
-export interface SearchInput {
-    query: string;
-    sources?: Array<"memoria" | "local" | "local_cli" | "builtin" | "registry" | "web">;
-    limit?: number;
-    learn?: boolean;
-    adopt?: boolean;
-    rebuild_index?: boolean;
-}
-/** Source priority for dedup (lower = higher priority). */
-export declare const SOURCE_PRIORITY: Record<SearchResult["source"], number>;
-/**
- * Dedup search results by name with source priority.
- * When the same name appears from multiple sources, keep the higher-priority one.
- */
-export declare function dedupSearchResults(results: SearchResult[], limit: number): SearchResult[];

package/dist/executors/search.d.ts

@@ -1,11 +0,0 @@
-/**
- * Executor for the native indexed regex search tool.
- *
- * Freshness architecture (frg parity):
- * 1. ARIA tool writes → recordSearchMutation → session overlay (0ms visibility)
- * 2. External edits → reconcileSearchGitDirty → session overlay (0ms visibility)
- * 3. Commit/version change → syncIndex or buildIndex (incremental/full)
- * 4. Session overlay passed to napi search() — no index rebuild needed
- */
-import type { ToolContext, ToolResult } from "../types.js";
-export declare function executeSearch(input: unknown, ctx: ToolContext): Promise<ToolResult>;

package/dist/executors/self-diagnose.d.ts

@@ -1,89 +0,0 @@
-/**
- * @aria/tools - Self-diagnose tool executor
- *
- * Pure signal diagnostic tool. 5 sections, zero noise:
- * 1. runtime  — process health + resource leaks
- * 2. errors   — structured errors from JSONL (active + rotated)
- * 3. crashes  — crash markers + dumps
- * 4. databases — sizes, WAL health, schema version
- * 5. daemon   — daemon audit + delegation journal
- */
-import type { ToolContext, ToolResult } from "../types.js";
-export interface SelfDiagnoseInput {
-    focus?: string;
-    sections?: string[];
-    since?: string;
-    limit?: number;
-}
-export interface RuntimeInfo {
-    pid: number;
-    uptime_s: number;
-    heap_mb: number;
-    rss_mb: number;
-    node_version: string;
-    platform: string;
-    arch: string;
-    cwd: string;
-    session_id: string | null;
-    socket_dirs: number;
-    owner_files: number;
-    relaunch_pending: boolean;
-}
-export interface ErrorEntry {
-    timestamp: string;
-    severity: string;
-    category: string;
-    message: string;
-    stackTrace: string;
-    source: string;
-}
-export interface CrashInfo {
-    file: string;
-    size?: number;
-    timestamp?: string;
-    error_message?: string;
-    content?: Record<string, unknown>;
-}
-export interface DbInfo {
-    name: string;
-    size_mb: string;
-    wal_mb: string | null;
-    modified: string;
-    schema_version?: number;
-}
-export interface DaemonEntry {
-    source: string;
-    entries: unknown[];
-}
-export interface NetworkInfo {
-    node_id: string | null;
-    display_name: string | null;
-    listen_port: number | null;
-    external_endpoint: string | null;
-    peer_count: number;
-    peers: Array<{
-        node_id: string;
-        name: string;
-        status: string;
-        last_seen: string | null;
-    }>;
-    tls_certs_present: boolean;
-    trusted_cas: number;
-    recent_tunnel_events: unknown[];
-    recent_diagnostics: unknown[];
-}
-export interface SelfDiagnoseOutput {
-    runtime: RuntimeInfo | null;
-    errors: ErrorEntry[] | null;
-    crashes: CrashInfo[] | null;
-    databases: DbInfo[] | null;
-    daemon: DaemonEntry[] | null;
-    network: NetworkInfo | null;
-    _meta: {
-        sections_requested: string[];
-        sections_returned: string[];
-        elapsed_ms: number;
-        errors: string[];
-    };
-}
-export declare function executeSelfDiagnose(input: SelfDiagnoseInput, ctx: ToolContext): Promise<ToolResult>;

package/dist/executors/session-history.d.ts

@@ -1,75 +0,0 @@
-/**
- * @aria/tools - Session History tool executor
- *
- * Implementation of session history operations for ARIA tool system.
- * Provides list, search, get, current, stats, delete, and set_title actions
- * against the SessionHistory SQLite database.
- */
-import type { ToolContext, ToolResult, SessionHistoryRef } from "../types.js";
-export type SessionHistoryAction = "list" | "search" | "get" | "current" | "stats" | "delete" | "set_title";
-export interface SessionHistoryInput {
-    /** Action to perform */
-    action: SessionHistoryAction;
-    /** Search query (for 'search' action) */
-    query?: string;
-    /** Session ID or prefix (for 'get', 'delete', 'set_title') */
-    sessionId?: string;
-    /** New title (for 'set_title' action) */
-    title?: string;
-    /** Max results (default 20) */
-    limit?: number;
-    /** Pagination offset (default 0) */
-    offset?: number;
-    /** Max messages to return per session (for 'get', default 50) */
-    messageLimit?: number;
-}
-export interface SessionListOutput {
-    sessions: Array<{
-        id: string;
-        title: string | null;
-        arion: string;
-        model: string;
-        messageCount: number;
-        updatedAt: string;
-        completedAt?: string;
-        preview: string;
-    }>;
-    total: number;
-    limit: number;
-    offset: number;
-}
-export interface SessionGetOutput {
-    id: string;
-    arion: string;
-    model: string;
-    messageCount: number;
-    messages: Array<{
-        role: string;
-        content: string;
-        createdAt: string;
-        toolCallId?: string;
-    }>;
-    metrics?: Array<{
-        turnCount?: number;
-        inputTokens?: number;
-        outputTokens?: number;
-        estimatedCost?: number;
-        wallTimeMs?: number;
-    }>;
-}
-export interface SessionCurrentOutput {
-    sessionId: string;
-}
-export interface SessionStatsOutput {
-    totalSessions: number;
-    incompleteSessions: number;
-}
-/**
- * Get the SessionHistoryRef — from ToolContext if wired, otherwise create
- * a fallback instance by dynamically importing @aria/cli's SessionHistory.
- */
-export declare function getSessionHistory(ctx: ToolContext): Promise<SessionHistoryRef | null>;
-/**
- * Execute a session_history action.
- */
-export declare function executeSessionHistory(input: SessionHistoryInput, ctx: ToolContext): Promise<ToolResult>;

package/dist/executors/shell-safety.d.ts

@@ -1,27 +0,0 @@
-/**
- * @aria/tools - Shell command risk classifier
- *
- * Statically classifies shell commands into risk tiers to gate execution:
- * - "safe"     : read-only, execute immediately without approval
- * - "moderate" : requires runtime policy handling (approval, allowlist, or autorun)
- * - "blocked"  : catastrophic, hard-denied — never execute
- */
-export type ShellRisk = "safe" | "moderate" | "blocked";
-/** Patterns that are unconditionally blocked — catastrophic risk. */
-export declare const BLOCKED_PATTERNS: RegExp[];
-/**
- * Classify a shell command's risk level.
- *
- * - "safe"     — skip approval, execute immediately
- * - "moderate" — handle via runtime policy (approval, allowlist, or autorun)
- * - "blocked"  — never execute, return error immediately
- */
-export declare function classifyCommand(command: string): ShellRisk;
-/**
- * Classify argv-based process execution (spawn/exec) with shell-aware behavior.
- *
- * When callers explicitly invoke a shell interpreter with `-c`, classify the
- * payload command text itself. This preserves catastrophic-command blocking
- * while avoiding false positives that would block every `bash -c ...` call.
- */
-export declare function classifyExecInvocation(program: string, args?: string[]): ShellRisk;