@aria-cli/tools 1.0.19 → 1.0.31

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

@@ -1,67 +0,0 @@
-import type { ChildProcessWithoutNullStreams } from "node:child_process";
-export type ProcessStatus = "running" | "completed" | "failed" | "killed";
-export type SessionStdin = {
-    write: (data: string, cb?: (err?: Error | null) => void) => void;
-    end: () => void;
-    destroy?: () => void;
-    destroyed?: boolean;
-};
-export interface ProcessSession {
-    id: string;
-    command: string;
-    notifyOnExit?: boolean;
-    notifyOnExitEmptySuccess?: boolean;
-    exitNotified?: boolean;
-    child?: ChildProcessWithoutNullStreams;
-    stdin?: SessionStdin;
-    pid?: number;
-    startedAt: number;
-    cwd?: string;
-    maxOutputChars: number;
-    pendingMaxOutputChars?: number;
-    totalOutputChars: number;
-    pendingStdout: string[];
-    pendingStderr: string[];
-    pendingStdoutChars: number;
-    pendingStderrChars: number;
-    aggregated: string;
-    tail: string;
-    exitCode?: number | null;
-    exitSignal?: NodeJS.Signals | number | null;
-    exited: boolean;
-    truncated: boolean;
-    backgrounded: boolean;
-}
-export interface FinishedSession {
-    id: string;
-    command: string;
-    startedAt: number;
-    endedAt: number;
-    cwd?: string;
-    status: ProcessStatus;
-    exitCode?: number | null;
-    exitSignal?: NodeJS.Signals | number | null;
-    aggregated: string;
-    tail: string;
-    truncated: boolean;
-    totalOutputChars: number;
-}
-export declare function createSessionSlug(): string;
-export declare function addSession(session: ProcessSession): void;
-export declare function getSession(id: string): ProcessSession | undefined;
-export declare function getFinishedSession(id: string): FinishedSession | undefined;
-export declare function deleteSession(id: string): void;
-export declare function appendOutput(session: ProcessSession, stream: "stdout" | "stderr", chunk: string): void;
-export declare function drainSession(session: ProcessSession): {
-    stdout: string;
-    stderr: string;
-};
-export declare function markExited(session: ProcessSession, exitCode: number | null, exitSignal: NodeJS.Signals | number | null, status: ProcessStatus): void;
-export declare function markBackgrounded(session: ProcessSession): void;
-export declare function tail(text: string, max?: number): string;
-export declare function trimWithCap(text: string, max: number): string;
-export declare function listRunningSessions(): ProcessSession[];
-export declare function listFinishedSessions(): FinishedSession[];
-export declare function clearFinished(): void;
-export declare function resetProcessRegistryForTests(): void;
-export declare function setJobTtlMs(value?: number): void;

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

@@ -1,9 +0,0 @@
-/**
- * process tool — ARIA Tool wrapper for background shell process management.
- *
- * Supports spawn/read/write/kill/list/send_key actions.
- * Uses node:child_process (no native deps).
- * Process registry forked from OpenClaw (MIT).
- */
-import type { Tool } from "../../types.js";
-export declare const processTool: Tool;

package/dist/definitions/process/pty-keys.d.ts

@@ -1,13 +0,0 @@
-export declare const BRACKETED_PASTE_START = "\u001B[200~";
-export declare const BRACKETED_PASTE_END = "\u001B[201~";
-export type KeyEncodingRequest = {
-    keys?: string[];
-    hex?: string[];
-    literal?: string;
-};
-export type KeyEncodingResult = {
-    data: string;
-    warnings: string[];
-};
-export declare function encodeKeySequence(request: KeyEncodingRequest): KeyEncodingResult;
-export declare function encodePaste(text: string, bracketed?: boolean): string;

package/dist/definitions/process/session-slug.d.ts

@@ -1 +0,0 @@
-export declare function createSessionSlug(isTaken?: (id: string) => boolean): string;

package/dist/definitions/quip.d.ts

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

package/dist/definitions/search.d.ts

@@ -1,9 +0,0 @@
-/**
- * Native indexed regex search tool definition.
- *
- * Uses @aria-cli/search (Rust napi-rs addon) for sub-millisecond indexed search.
- * Registered alongside (not replacing) the existing grep tool.
- */
-import type { Tool } from "../types.js";
-export declare const searchTool: Tool;
-export declare const SEARCH_TOOL_DEFINITIONS: Tool[];

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

@@ -1,11 +0,0 @@
-/**
- * Session History tool definitions
- *
- * Tools: session_history (1 tool with multi-action pattern)
- *
- * Provides list, search, get, current, stats, delete, and set_title
- * actions against the SessionHistory SQLite database.
- */
-import type { Tool } from "../types.js";
-/** Session History tool definitions (1) */
-export declare const SESSION_HISTORY_TOOL_DEFINITIONS: Tool[];

package/dist/definitions/shell.d.ts

@@ -1,8 +0,0 @@
-/**
- * Shell tool definitions
- *
- * Tools: bash, exec, spawn, kill, write_stdin, list_processes, wait_process (7 tools)
- */
-import type { Tool } from "../types.js";
-/** Shell tool definitions (7) */
-export declare const SHELL_TOOL_DEFINITIONS: Tool[];

package/dist/definitions/slack.d.ts

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

package/dist/definitions/web.d.ts

@@ -1,8 +0,0 @@
-/**
- * Web tool definitions
- *
- * Tools: web_search, web_fetch, browse (3 tools)
- */
-import type { Tool } from "../types.js";
-/** Web tool definitions (3) */
-export declare const WEB_TOOL_DEFINITIONS: Tool[];

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

@@ -1,51 +0,0 @@
-/**
- * @aria/tools - Apply Patch executor
- *
- * Parses and applies unified diff patches with:
- * - Path traversal protection (SECURITY-CRITICAL)
- * - Atomic writes (all-or-nothing application)
- * - Fuzzy hunk matching (offset tolerance)
- * - CRLF normalization
- */
-import type { ToolContext, ToolResult } from "../types.js";
-export interface ApplyPatchInput {
-    /** Unified diff format patch content */
-    patch: string;
-    /** Working directory for relative paths in the patch */
-    cwd?: string;
-}
-/** A single hunk within a file diff */
-interface Hunk {
-    /** Original file start line (1-based) */
-    oldStart: number;
-    /** Number of lines in original */
-    oldCount: number;
-    /** Modified file start line (1-based) */
-    newStart: number;
-    /** Number of lines in modified */
-    newCount: number;
-    /** Lines in the hunk: each prefixed with ' ', '+', or '-' */
-    lines: string[];
-}
-/** A diff for a single file */
-interface FileDiff {
-    /** Original file path (null for new files) */
-    oldPath: string | null;
-    /** Modified file path (null for deleted files) */
-    newPath: string | null;
-    /** Hunks to apply */
-    hunks: Hunk[];
-}
-/**
- * Parse a unified diff string into an array of file diffs.
- * Handles standard unified diff and git-style diffs.
- */
-export declare function parseUnifiedDiff(patch: string): FileDiff[];
-/**
- * Execute the apply_patch tool.
- *
- * Parses a unified diff, validates all paths for security,
- * and applies changes atomically.
- */
-export declare function executeApplyPatch(input: ApplyPatchInput, ctx: ToolContext): Promise<ToolResult>;
-export {};

package/dist/executors/arion.d.ts

@@ -1,50 +0,0 @@
-/**
- * @aria/tools - Arion tool executors
- *
- * Implementation of arion operations for ARIA tool system.
- * These executors create and manage arion personas.
- */
-import type { ToolContext, ToolResult } from "../types.js";
-export interface HatchArionInput {
-    /** Name for the new arion */
-    name: string;
-    /** Visual emoji identifier */
-    emoji?: string;
-    /** Core personality traits */
-    traits: string[];
-    /** Communication style */
-    style: "formal" | "casual" | "technical" | "friendly";
-    /** Core beliefs to seed memory with */
-    beliefs?: string[];
-    /** Brief backstory */
-    background?: string;
-    /** Unique behavioral quirks */
-    quirks?: string[];
-    /** Areas of strength */
-    strengths?: string[];
-}
-export interface HatchArionOutput {
-    /** ID of the created arion */
-    arionId: string;
-    /** Name of the arion */
-    name: string;
-    /** Emoji of the arion */
-    emoji: string;
-}
-/**
- * Creates a new arion persona with the specified configuration.
- * Requires user confirmation and arion context (manager) to execute.
- */
-export declare function executeHatchArion(input: HatchArionInput, ctx: ToolContext): Promise<ToolResult>;
-export interface RestArionInput {
-    name: string;
-}
-export declare function executeRestArion(input: RestArionInput, ctx: ToolContext): Promise<ToolResult>;
-export interface WakeArionInput {
-    name: string;
-}
-export declare function executeWakeArion(input: WakeArionInput, ctx: ToolContext): Promise<ToolResult>;
-export interface RetireArionInput {
-    name: string;
-}
-export declare function executeRetireArion(input: RetireArionInput, ctx: ToolContext): Promise<ToolResult>;

package/dist/executors/code-intelligence.d.ts

@@ -1,138 +0,0 @@
-/**
- * @aria/tools - Code intelligence executors
- *
- * 7 native tools wrapping external CLI binaries:
- * rg (ripgrep), ug (ugrep), probe, sg (ast-grep),
- * cbm (codebase-memory-mcp), serena, fff
- */
-import type { ToolContext, ToolResult } from "../types.js";
-export interface RgInput {
-    pattern: string;
-    path?: string;
-    ignore_case?: boolean;
-    smart_case?: boolean;
-    fixed_strings?: boolean;
-    word_regexp?: boolean;
-    file_type?: string;
-    glob?: string;
-    context?: number;
-    max_count?: number;
-    invert?: boolean;
-    files_only?: boolean;
-    count?: boolean;
-    extra_args?: string[];
-}
-export interface UgInput {
-    pattern: string;
-    path?: string;
-    ignore_case?: boolean;
-    smart_case?: boolean;
-    fixed_strings?: boolean;
-    word_regexp?: boolean;
-    file_type?: string;
-    glob?: string;
-    context?: number;
-    max_count?: number;
-    fuzzy?: boolean | number;
-    bool?: boolean;
-    neg_pattern?: string;
-    files_only?: boolean;
-    count?: boolean;
-    decompress?: boolean;
-    extra_args?: string[];
-}
-export interface ProbeInput {
-    command?: "search" | "extract" | "symbols" | "query";
-    query?: string;
-    path?: string;
-    exact?: boolean;
-    max_tokens?: number;
-    max_results?: number;
-    session?: string;
-    language?: string;
-    reranker?: string;
-    allow_tests?: boolean;
-    files?: string[];
-    extra_args?: string[];
-}
-export interface SgInput {
-    command?: "run" | "scan";
-    pattern?: string;
-    language?: string;
-    rewrite?: string;
-    strictness?: "cst" | "smart" | "ast" | "relaxed" | "signature";
-    globs?: string;
-    rule?: string;
-    inline_rules?: string;
-    path?: string;
-    update_all?: boolean;
-    context?: number;
-    extra_args?: string[];
-}
-export interface CbmInput {
-    action: "index" | "search" | "trace" | "impact" | "context" | "snippet" | "code_search" | "architecture" | "schema" | "cypher" | "list_projects" | "delete_project" | "status";
-    path?: string;
-    mode?: "full" | "fast";
-    name?: string;
-    label?: string;
-    file?: string;
-    direction?: "inbound" | "outbound" | "both";
-    depth?: number;
-    edge_types?: string[];
-    scope?: string;
-    base_branch?: string;
-    qualified_name?: string;
-    include_neighbors?: boolean;
-    code_pattern?: string;
-    regex?: boolean;
-    code_mode?: "compact" | "full" | "files";
-    query?: string;
-    max_rows?: number;
-    project?: string;
-    limit?: number;
-    context?: number;
-}
-export interface LspInput {
-    action: "definition" | "references" | "hover" | "symbols" | "rename";
-    file: string;
-    line?: number;
-    character?: number;
-    new_name?: string;
-}
-export interface SerenaInput {
-    action: "find_symbol" | "find_references" | "overview" | "replace_body" | "insert_after" | "insert_before" | "rename" | "search";
-    name_path?: string;
-    relative_path?: string;
-    include_body?: boolean;
-    include_info?: boolean;
-    depth?: number;
-    body?: string;
-    new_name?: string;
-    pattern?: string;
-    context_before?: number;
-    context_after?: number;
-    paths_include?: string;
-    paths_exclude?: string;
-    extra_args?: Record<string, unknown>;
-}
-export interface FffInput {
-    action: "grep" | "find_files" | "multi_grep";
-    query?: string;
-    patterns?: string[];
-    constraints?: string;
-    path?: string;
-}
-export interface RgMatch {
-    file: string;
-    line: number;
-    text: string;
-    submatches: string[];
-}
-export declare function executeRg(input: RgInput, ctx: ToolContext): Promise<ToolResult>;
-export declare function executeUg(input: UgInput, ctx: ToolContext): Promise<ToolResult>;
-export declare function executeProbe(input: ProbeInput, ctx: ToolContext): Promise<ToolResult>;
-export declare function executeSg(input: SgInput, ctx: ToolContext): Promise<ToolResult>;
-export declare function executeCbm(input: CbmInput, ctx: ToolContext): Promise<ToolResult>;
-export declare function executeLsp(input: LspInput, ctx: ToolContext): Promise<ToolResult>;
-export declare function executeSerena(input: SerenaInput, ctx: ToolContext): Promise<ToolResult>;
-export declare function executeFff(input: FffInput, ctx: ToolContext): Promise<ToolResult>;

package/dist/executors/deploy.d.ts

@@ -1,169 +0,0 @@
-/**
- * @aria/tools - Deploy tool executor
- *
- * Deploys ARIA to a remote machine via SSH. Handles OS detection,
- * Node.js installation, repo setup, keypair generation, TLS cert
- * discovery/provisioning, firewall configuration, config writing,
- * daemon startup, and health check.
- */
-import type { ToolContext, ToolResult } from "../types.js";
-export interface DeployInput {
-    /** SSH target (e.g. "claude@10.0.0.1") */
-    target: string;
-    /** Git repo URL (default: current origin) */
-    repo_url?: string;
-    /** Branch to deploy (default: main) */
-    branch?: string;
-    /** Arion identity name (default: hostname of target) */
-    arion_name?: string;
-    /** Mesh coordination URL */
-    coordination_url?: string;
-    /** Path to SSH private key */
-    ssh_key_path?: string;
-    /** Git commit hash to checkout after clone (pins exact code version) */
-    commit_hash?: string;
-    /** Verify GPG signature on HEAD commit after checkout */
-    verify_signatures?: boolean;
-}
-export interface DeployOutput {
-    success: boolean;
-    host: string;
-    port: number | null;
-    fingerprint: string | null;
-    arionName: string;
-    tlsType: TlsType | null;
-}
-export type TlsType = "real-ca" | "letsencrypt" | "private-ca";
-export interface OSInfo {
-    os: "linux" | "darwin" | "windows" | "unknown";
-}
-export type LinuxDistro = "apt" | "dnf" | "apk";
-export type FirewallType = "ufw" | "iptables" | "firewalld" | "windows" | "none";
-export interface TlsDiscoveryResult {
-    found: boolean;
-    type?: TlsType;
-    cert?: string;
-    key?: string;
-}
-/**
- * Detect OS type from `uname -s` output.
- */
-export declare function detectOS(unameOutput: string): OSInfo;
-/**
- * Detect Linux distribution from /etc/os-release content.
- * Returns the package manager type to use.
- */
-export declare function detectLinuxDistro(osReleaseContent: string): LinuxDistro;
-/**
- * Get the shell command to install Node.js for a given OS and distro.
- */
-export declare function getNodeInstallCommand(osInfo: OSInfo, distro: LinuxDistro): string;
-/**
- * Generate firewall commands to open ARIA ports (443/tcp + 51820/udp).
- */
-export declare function getFirewallCommands(firewallType: FirewallType): string;
-/**
- * Parse TLS cert discovery output from the remote host.
- * The discovery script outputs JSON: { found, type?, cert?, key? }
- */
-export declare function discoverTlsCerts(sshOutput: string): TlsDiscoveryResult;
-/**
- * Build the config JSON object for ~/.aria/config.json.
- */
-export declare function buildConfigJson(params: {
-    arionName: string;
-    coordinationUrl?: string;
-    tlsCert?: string;
-    tlsKey?: string;
-}): Record<string, unknown>;
-/**
- * Construct the health check URL for the deployed daemon.
- */
-export declare function buildHealthCheckUrl(host: string, port?: number): string;
-/**
- * Validate git repo URL — must be HTTPS with no shell metacharacters.
- */
-export declare function validateRepoUrl(url: string): string | null;
-/**
- * Validate branch name — alphanumeric, dots, slashes, hyphens, underscores.
- * Rejects shell metacharacters and path traversal.
- */
-export declare function validateBranch(branch: string): string | null;
-/**
- * Validate arion name — alphanumeric, underscores, hyphens only.
- */
-export declare function validateArionName(name: string): string | null;
-/**
- * Validate SSH key path — reject traversal and shell metacharacters.
- */
-export declare function validateSshKeyPath(keyPath: string): string | null;
-/**
- * Validate git commit hash — must be 7-64 lowercase hex characters.
- * Rejects non-hex, too-short, and shell injection attempts.
- */
-export declare function validateCommitHash(hash: string): string | null;
-/**
- * Pinned pnpm version — matches packageManager field in root package.json.
- * Prevents unpinned `pnpm@latest` from pulling a compromised version.
- */
-export declare const PINNED_PNPM_VERSION = "10.28.2";
-/**
- * Represents a mutating deploy step that can be undone.
- */
-export interface DeployStep {
-    /** Human-readable step name */
-    name: string;
-    /** Shell command to reverse this step (empty string = not reversible) */
-    undoCmd: string;
-}
-/**
- * Get firewall undo commands to reverse port-opening rules.
- */
-export declare function getFirewallUndoCommands(firewallType: FirewallType): string;
-/**
- * Build rollback commands from recorded deploy steps.
- * Returns commands in reverse order (last step undone first).
- * Skips steps with empty undoCmd.
- */
-export declare function buildRollbackCommands(steps: DeployStep[]): string[];
-/**
- * Deep-merge two config objects. Preserves nested objects from existing config
- * while applying updates. Does not mutate inputs.
- */
-export declare function deepMergeConfig(existing: Record<string, unknown>, update: Record<string, unknown>): Record<string, unknown>;
-/**
- * Get chmod commands to restrict key and config file permissions to owner-only.
- */
-export declare function getKeyPermissionCommands(): string;
-/**
- * Execute a command on the remote host via SSH.
- * Returns { stdout, stderr, exitCode }.
- */
-export declare function sshExec(target: string, command: string, options?: {
-    sshKeyPath?: string;
-    timeoutMs?: number;
-    abortSignal?: AbortSignal;
-}): Promise<{
-    stdout: string;
-    stderr: string;
-    exitCode: number;
-}>;
-/**
- * Deploy ARIA to a remote machine via SSH.
- *
- * Steps:
- * 1. SSH connectivity check
- * 2. OS detection (uname -s)
- * 3. Linux distro detection (for package manager selection)
- * 4. Install Node.js 20+ if missing
- * 5. Enable corepack + pnpm
- * 6. Clone or update repo
- * 7. pnpm install && pnpm build
- * 8. Generate Ed25519 signing keypair if not present
- * 9. TLS cert discovery + optional provisioning
- * 10. Firewall port opening (443/tcp + 51820/udp)
- * 11. Write ~/.aria/config.json
- * 12. Start daemon on port 443
- * 13. Health check (curl endpoint)
- */
-export declare function executeDeploy(input: DeployInput, ctx: ToolContext): Promise<ToolResult>;