@aria-cli/tools 1.0.18 → 1.0.31

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

package/dist-cjs/executors/filesystem.d.ts

@@ -1,150 +0,0 @@
-/**
- * @aria/tools - Filesystem tool executors
- *
- * Implementation of filesystem operations for ARIA tool system.
- */
-import type { ToolContext, ToolResult } from "../types.js";
-/**
- * Hard output caps to avoid overwhelming tool responses.
- * read_file already has media-size capping and line slicing support.
- */
-export declare const FILESYSTEM_OUTPUT_LIMITS: {
-    readonly MAX_GLOB_RESULTS: 2000;
-    readonly MAX_GREP_MATCHES: 2000;
-    readonly MAX_GREP_ERRORS: 200;
-    readonly MAX_GREP_FILE_BYTES: number;
-    readonly MAX_GREP_LINE_BYTES: number;
-};
-export interface ReadFileInput {
-    path: string;
-    /** File encoding */
-    encoding?: string;
-    /** Line offset (0-based) to start reading from */
-    offset?: number;
-    /** Number of lines to read */
-    limit?: number;
-}
-/**
- * Reads a file's contents.
- */
-export declare function executeReadFile(input: ReadFileInput, ctx: ToolContext): Promise<ToolResult>;
-export interface WriteFileInput {
-    path: string;
-    content: string;
-    /** File encoding */
-    encoding?: string;
-    /** Append to file instead of overwriting */
-    append?: boolean;
-    /**
-     * Optional optimistic concurrency guard.
-     * If provided, write only succeeds when current file content hash matches this value.
-     */
-    expectedHash?: string;
-}
-/**
- * Writes content to a file.
- */
-export declare function executeWriteFile(input: WriteFileInput, ctx: ToolContext): Promise<ToolResult>;
-export interface EditFileInput {
-    path: string;
-    oldText: string;
-    newText: string;
-    /** Replace all occurrences instead of just the first */
-    replaceAll?: boolean;
-    /**
-     * Optional replacement count assertion.
-     * When provided, the edit fails unless this exact number of replacements is applied.
-     */
-    expectedReplacements?: number;
-    /**
-     * Optional optimistic concurrency guard.
-     * If provided, edit only succeeds when current file content hash matches this value.
-     */
-    expectedHash?: string;
-}
-/**
- * Edits a file by replacing text.
- */
-export declare function executeEditFile(input: EditFileInput, ctx: ToolContext): Promise<ToolResult>;
-export interface ListDirInput {
-    path?: string;
-    /** Include dotfiles and dot-directories */
-    all?: boolean;
-    /** Include detailed metadata fields */
-    long?: boolean;
-    /** Recursion depth: 1 lists immediate children, 2 includes grandchildren, etc. */
-    depth?: number;
-    /** Maximum number of entries to return */
-    limit?: number;
-    /** Number of entries to skip before returning */
-    offset?: number;
-    /** Glob patterns to ignore */
-    ignore?: string[];
-}
-/** Backward-compatible ls input alias. */
-export interface LsInput extends ListDirInput {
-}
-export interface LsEntry {
-    name: string;
-    type: "file" | "directory" | "symlink" | "other";
-    /** File size in bytes (present when long=true) */
-    size?: number;
-    /** POSIX mode bits as a zero-padded octal string, e.g. "644" */
-    mode?: string;
-    /** Last modified time in epoch milliseconds (integer, present when long=true) */
-    mtimeMs?: number;
-    /** Last modified time as ISO-8601 string (present when long=true) */
-    modifiedAt?: string;
-}
-export interface ListDirEntry extends LsEntry {
-    /** Relative path from listing root */
-    path: string;
-    /** Depth from listing root where 1 is an immediate child */
-    depth: number;
-}
-export interface ListDirOutput {
-    path: string;
-    depth: number;
-    limit: number;
-    offset: number;
-    ignore: string[];
-    truncated: boolean;
-    total: number;
-    entries: ListDirEntry[];
-}
-export declare const LS_INTERNALS: {
-    readType(entryPath: string): Promise<LsEntry["type"]>;
-    readMetadata(entryPath: string): Promise<Required<Pick<LsEntry, "size" | "mode" | "mtimeMs" | "modifiedAt">>>;
-};
-/**
- * List files and directories with structured metadata.
- */
-export declare function executeLs(input: ListDirInput, ctx: ToolContext): Promise<ToolResult>;
-export interface GlobInput {
-    pattern: string;
-    /** Working directory for the glob */
-    cwd?: string;
-    /** Patterns to ignore */
-    ignore?: string[];
-}
-/**
- * Finds files matching a glob pattern.
- */
-export declare function executeGlob(input: GlobInput, ctx: ToolContext): Promise<ToolResult>;
-export interface GrepInput {
-    pattern: string;
-    path?: string;
-    /** Glob pattern to filter files */
-    glob?: string;
-    /** Case insensitive search */
-    ignoreCase?: boolean;
-}
-export interface GrepMatch {
-    file: string;
-    line: number;
-    content: string;
-}
-/**
- * Searches for a pattern in files.
- */
-export declare function executeGrep(input: GrepInput, ctx: ToolContext): Promise<ToolResult>;

package/dist-cjs/executors/frg-freshness.d.ts

@@ -1,93 +0,0 @@
-import { type FrgSearchMatch } from "@aria-cli/fastripgrep";
-export type FrgMutationOperation = "write" | "delete";
-export interface FrgMutationRecord {
-    repoRoot: string;
-    path: string;
-    operation: FrgMutationOperation;
-    sequence: number;
-    recordedAt: number;
-    content?: string;
-}
-export interface FrgSessionDeltaSearchOptions {
-    pattern: string;
-    context?: number;
-    caseInsensitive?: boolean;
-    smartCase?: boolean;
-    literal?: boolean;
-    glob?: string;
-    fileType?: string;
-    filesOnly?: boolean;
-    count?: boolean;
-    quiet?: boolean;
-    maxCount?: number;
-}
-export interface FrgSessionDeltaSearchResult {
-    mode: "matches" | "files" | "counts" | "quiet";
-    matches?: FrgSearchMatch[];
-    files?: string[];
-    counts?: Array<{
-        file: string;
-        count: number;
-    }>;
-    matched?: boolean;
-}
-export interface FrgGitDirtyStatus {
-    headCommit?: string;
-    headTree?: string;
-    tracked: Array<{
-        path: string;
-        operation: FrgMutationOperation;
-    }>;
-    untracked: string[];
-}
-export interface FrgFlushStatus {
-    inFlight: boolean;
-    scheduled: boolean;
-    lastScheduledAt?: number;
-    lastFlushAt?: number;
-    lastError?: string;
-    retryCount: number;
-    retryDelayMs?: number;
-}
-export interface FrgFreshnessSnapshot {
-    headCommit?: string;
-    headTree?: string;
-    dirtyTrackedCount: number;
-    dirtyUntrackedCount: number;
-    sessionPendingCount: number;
-    sessionPendingBytes: number;
-    flush: FrgFlushStatus;
-    freshnessState: "missing" | "fresh" | "session-dirty" | "overlay-dirty" | "head-mismatch" | "syncing" | "sync-scheduled" | "stale";
-}
-export declare const DEFAULT_BACKGROUND_FRG_FLUSH_DELAY_MS = 750;
-export declare const BACKGROUND_FRG_MAX_FLUSH_DELAY_MS = 30000;
-export declare const MAX_PENDING_MUTATIONS_BEFORE_SYNC_FLUSH = 32;
-export declare const MAX_PENDING_MUTATION_BYTES_BEFORE_SYNC_FLUSH: number;
-export declare const MAX_CACHED_MUTATION_CONTENT_BYTES: number;
-export declare function getTrackedRepoRootForPath(filePath: string): string | null;
-export declare function ensureFrgRepoStateLoaded(repoRoot: string): void;
-export declare function recordFrgMutation(filePath: string, operation: FrgMutationOperation, content?: string): void;
-export declare function getPendingFrgMutations(repoRoot: string): FrgMutationRecord[];
-export declare function getPendingFrgMutationBytes(repoRoot: string): number;
-export declare function clearPendingFrgMutations(repoRoot: string): void;
-export declare function flushPendingFrgMutations(repoRoot: string): {
-    flushed: false;
-    reason: string;
-    pendingCount: number;
-} | {
-    flushed: true;
-    pendingCount: number;
-    result: unknown;
-};
-export declare function maybeBuildFrgIndexForRepo(repoRoot: string): void;
-export declare function scheduleBackgroundFrgFlush(repoRoot: string, delayMs?: number): void;
-export declare function shouldForceSynchronousFrgFlush(repoRoot: string): boolean;
-export declare function getFrgFlushStatus(repoRoot: string): FrgFlushStatus;
-export declare function getGitDirtyStatus(repoRoot: string): FrgGitDirtyStatus;
-export declare function reconcileGitDirtyMutations(repoRoot: string): FrgGitDirtyStatus;
-export declare function getFrgFreshnessSnapshot(repoRoot: string, indexed?: {
-    commit_hash?: string | null;
-    tree_hash?: string | null;
-    age_seconds?: number;
-}): FrgFreshnessSnapshot;
-export declare function searchPendingFrgMutations(repoRoot: string, options: FrgSessionDeltaSearchOptions): Promise<FrgSessionDeltaSearchResult | null>;

package/dist-cjs/executors/frg.d.ts

@@ -1,27 +0,0 @@
-import type { ToolContext, ToolResult } from "../types.js";
-export interface FrgInput {
-    command: "index" | "search" | "update" | "status" | "replace" | "init" | "watch" | "man" | "completions" | "upgrade";
-    pattern?: string;
-    replacement?: string;
-    path?: string;
-    noIndex?: boolean;
-    literal?: boolean;
-    caseInsensitive?: boolean;
-    smartCase?: boolean;
-    filesOnly?: boolean;
-    count?: boolean;
-    maxCount?: number;
-    quiet?: boolean;
-    context?: number;
-    json?: boolean;
-    glob?: string;
-    fileType?: string;
-    follow?: boolean;
-    extraPatterns?: string[];
-    maxFilesize?: number;
-    force?: boolean;
-    write?: boolean;
-    hook?: boolean;
-    shell?: "bash" | "elvish" | "fish" | "powershell" | "zsh";
-}
-export declare function executeFrg(input: unknown, ctx: ToolContext): Promise<ToolResult>;

package/dist-cjs/executors/learning-meta.d.ts

@@ -1,87 +0,0 @@
-/**
- * @aria/tools - Learning/meta capability executors
- *
- * Tools:
- * - search: discover tools/skills across memoria, local skill files, and optional web
- * - learn_tool: learn a CLI tool from `--help` output
- * - learn_skill: learn a skill from SKILL.md file or inline content
- * - create_tool: create a reusable script-backed tool and persist it in Memoria
- * - create_skill: persist a skill and optionally link it to the active arion
- * - use_skill: fetch a skill by name/id and record execution metrics
- */
-import type { ToolContext, ToolResult } from "../types.js";
-import type { SearchResult, OSContext, SearchInput } from "./search-types.js";
-/** Fetch JSON from a URL with a short timeout. Respects caller's AbortSignal. */
-export declare function fetchJson(url: string, timeoutMs?: number, callerSignal?: AbortSignal): Promise<Record<string, unknown> | null>;
-export interface SearchKnowledgeInput extends SearchInput {
-}
-export declare function getOSContext(): OSContext;
-/**
- * Like Promise.allSettled but with a deadline. Returns whatever has settled
- * by the deadline; tasks still pending are actively aborted via AbortSignal.
- * Reports how many timed out.
- */
-export type DeadlineTask<T> = Promise<T> | ((signal: AbortSignal) => Promise<T>);
-export declare function settleWithDeadline<T>(tasks: Array<DeadlineTask<T>>, deadlineMs: number, callerSignal?: AbortSignal): Promise<{
-    settled: Array<PromiseSettledResult<T>>;
-    timedOut: number;
-}>;
-export declare function searchMemoria(memoria: NonNullable<ToolContext["memoria"]>, query: string, limit: number, callerSignal?: AbortSignal): Promise<SearchResult[]>;
-export declare function searchLocalSkills(query: string, workingDir: string, limit: number, callerSignal?: AbortSignal, env?: Record<string, string | undefined>): Promise<SearchResult[]>;
-export declare function searchSkillRegistries(query: string, limit: number, callerSignal?: AbortSignal): Promise<SearchResult[]>;
-export declare function searchWeb(query: string, limit: number, platform?: OSContext, callerSignal?: AbortSignal): Promise<SearchResult[]>;
-export declare function executeSearchKnowledge(input: SearchKnowledgeInput, ctx: ToolContext): Promise<ToolResult>;
-export interface LearnToolInput {
-    command: string;
-    name?: string;
-    description?: string;
-    category?: "filesystem" | "code" | "shell" | "web" | "data" | "memory" | "meta" | "arion";
-}
-export declare function executeLearnTool(input: LearnToolInput, ctx: ToolContext): Promise<ToolResult>;
-export interface LearnSkillInput {
-    path?: string;
-    name?: string;
-    description?: string;
-    content?: string;
-    tags?: string[];
-    toolIds?: string[];
-}
-export declare function executeLearnSkill(input: LearnSkillInput, ctx: ToolContext): Promise<ToolResult>;
-export interface LearnLegacyInput {
-    source?: {
-        type: "cli";
-        command: string;
-    } | {
-        type: "file";
-        path: string;
-    };
-    /** Content-only input — routes to remember() for general knowledge storage */
-    content?: string;
-}
-export declare function executeLearnLegacy(input: LearnLegacyInput, ctx: ToolContext): Promise<ToolResult>;
-export interface CreateToolInput {
-    name: string;
-    description: string;
-    command?: string;
-    script?: string;
-    argsSchema?: Record<string, unknown>;
-    tags?: string[];
-}
-export declare function executeCreateTool(input: CreateToolInput, ctx: ToolContext): Promise<ToolResult>;
-export interface CreateSkillInput {
-    name: string;
-    description: string;
-    content: string;
-    level?: "beginner" | "intermediate" | "advanced" | "expert";
-    tags?: string[];
-    toolIds?: string[];
-}
-export declare function executeCreateSkill(input: CreateSkillInput, ctx: ToolContext): Promise<ToolResult>;
-export interface UseSkillInput {
-    name?: string;
-    skillId?: string;
-    success?: boolean;
-    durationMs?: number;
-    notes?: string;
-}
-export declare function executeUseSkill(input: UseSkillInput, ctx: ToolContext): Promise<ToolResult>;

package/dist-cjs/executors/lsp-client.d.ts

@@ -1,38 +0,0 @@
-/**
- * Native LSP Client — uses vscode-jsonrpc for proper message framing.
- *
- * Same approach as Claude Code: createMessageConnection over stdio.
- * Same configuration as Claude Code's LSP plugins.
- * Supports: TypeScript, Python, Go, Rust, C/C++, Swift, Java, Kotlin, Lua, PHP, Ruby, C#.
- */
-export interface LspServerConfig {
-    command: string;
-    args: string[];
-    extensionToLanguage: Record<string, string>;
-    startupTimeout: number;
-}
-export declare const LSP_SERVERS: Record<string, LspServerConfig>;
-export declare function getServerForFile(filePath: string): string | undefined;
-export declare function getLanguageId(filePath: string): string | undefined;
-export declare class LspServer {
-    private process;
-    private connection;
-    private initialized;
-    private openFiles;
-    private diagnosticsReceived;
-    readonly serverName: string;
-    readonly config: LspServerConfig;
-    private rootUri;
-    constructor(serverName: string, rootPath: string);
-    start(): Promise<void>;
-    stop(): Promise<void>;
-    openFile(filePath: string): Promise<void>;
-    definition(filePath: string, line: number, character: number): Promise<unknown>;
-    references(filePath: string, line: number, character: number): Promise<unknown>;
-    hover(filePath: string, line: number, character: number): Promise<unknown>;
-    documentSymbols(filePath: string): Promise<unknown>;
-    rename(filePath: string, line: number, character: number, newName: string): Promise<unknown>;
-    private ensureReady;
-}
-export declare function getOrCreateServer(serverName: string, rootPath: string): LspServer;
-export declare function shutdownAll(): Promise<void>;