@aria-cli/tools 1.0.18 → 1.0.31

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

@@ -1,203 +0,0 @@
-/**
- * @aria/tools - Memory tool executors
- *
- * Implementation of memory operations for ARIA tool system.
- * These executors integrate with Memoria for persistent memory management.
- */
-import type { MemoryItem, ToolItem, SkillItem } from "@aria-cli/types";
-import type { ToolContext, ToolResult } from "../types.js";
-/**
- * Typed shape for the `ctx.context` field used by memory executors.
- * The runner populates this from conversation messages and system prompt sections.
- * Memory executors cast `ctx.context as RecallToolContext` to access these fields.
- *
- * This avoids adding new top-level fields to ToolContext — uses the existing
- * `context?: unknown` field instead.
- */
-export interface RecallToolContext {
-    /** Last N conversation turns (role + truncated content) from the current session. */
-    conversationContext?: Array<{
-        role: string;
-        content: string;
-    }>;
-    /** Pre-extracted system prompt sections for self-context queries. */
-    systemPromptSections?: Record<string, string>;
-}
-/**
- * Get the last N turns from the current conversation.
- * Reads from the RecallToolContext populated by the runner.
- *
- * @param messages - conversation messages from ctx.context.conversationContext
- * @param args.turns - number of turns to return (default 5; 1 turn = 2 messages)
- * @returns last N*2 messages (user+assistant pairs)
- */
-export declare function getConversationContext(messages: Array<{
-    role: string;
-    content: string;
-}> | undefined, args: {
-    turns?: number;
-}): Array<{
-    role: string;
-    content: string;
-}>;
-type TranscriptMessage = {
-    role: string;
-    content: string;
-};
-/**
- * Get transcript from a past session by reading Claude Code JSONL session files.
- *
- * Scans ~/.claude/projects/ for JSONL session files, parses user/assistant messages,
- * and returns the last N turns from the most recent (or specified) session.
- *
- * Lightweight JSONL reader implemented directly in the tools package to avoid
- * importing from @aria/memoria-bridge. Includes symlink safety checks and
- * content truncation.
- *
- * @param args.sessionId - session ID (or partial path match) to retrieve (default: most recent)
- * @param args.turns - number of turns to return (default 10; 1 turn = 2 messages)
- * @returns array of {role, content} messages from the session
- */
-export declare function getSessionTranscript(args: {
-    sessionId?: string;
-    turns?: number;
-}): Promise<TranscriptMessage[]>;
-/** Valid self-context section names that map to system prompt headings. */
-export type SelfContextSection = "memory" | "strategies" | "profile" | "context";
-/**
- * Read a section of the agent's own system prompt.
- * This is a NO-DB-QUERY primitive — the data was already extracted from the
- * system prompt at session start and stored in RecallToolContext.systemPromptSections.
- *
- * Sections:
- * - "memory": observations, current-task, suggested-response (from ## Memory)
- * - "strategies": relevant procedures and behavioral rules (from ## Relevant Procedures)
- * - "profile": user info (from ## What I know about...)
- * - "context": background memories recalled at session start (from ## Background Context)
- *
- * @param sections - pre-extracted system prompt sections from RecallToolContext
- * @param args.section - which section to retrieve
- * @returns the section content, or null if section is unknown or not present
- */
-export declare function getSelfContext(sections: Record<string, string> | undefined, args: {
-    section: string;
-}): string | null;
-export interface RememberInput {
-    /** Content to store in memory */
-    content: string;
-    /** Optional importance score (0.0-1.0) */
-    importance?: number;
-}
-export interface RememberOutput {
-    /** ID of the stored memory */
-    id: string;
-}
-/**
- * Store content in Memoria with optional importance.
- */
-export declare function executeRemember(input: RememberInput, ctx: ToolContext): Promise<ToolResult>;
-export interface RecallInput {
-    /** Query to search memories */
-    query: string;
-    /** Direct memory ID lookup (from [mem:id] progressive disclosure format) */
-    id?: string;
-    /** Maximum number of results (default: 10) */
-    limit?: number;
-    /** Optional tags to filter memories by */
-    tags?: string[];
-    /** ISO 8601 date string for temporal query — returns memories valid at this date */
-    date?: string;
-}
-export interface RecallOutput {
-    /** Retrieved memories */
-    memories: MemoryItem[];
-    /** Total count of returned memories */
-    count: number;
-    /** Formatted context string from APR (when available) */
-    formattedContext?: string;
-    /** Classified intent type from APR (when available) */
-    intent?: string;
-    /** Per-index source statistics from APR (when available) */
-    sourceStats?: Record<string, number>;
-    /** UCR planner reasoning (when available) */
-    planReasoning?: string;
-    /** UCR primitive results from non-memory sources (when available) */
-    primitiveResults?: Array<{
-        source: string;
-        data: unknown;
-    }>;
-}
-/**
- * Retrieve memories by query from Memoria.
- *
- * Uses recallWithAPR when available to capture formattedContext,
- * intent, and sourceStats metadata. Falls back to plain recall() with
- * reranking + diversity options for backward compatibility.
- */
-export declare function executeRecall(input: RecallInput, ctx: ToolContext): Promise<ToolResult>;
-export interface ForgetInput {
-    /** ID of the memory to delete */
-    id: string;
-}
-export interface ForgetOutput {
-    /** Whether the memory was deleted */
-    deleted: boolean;
-    /** ID of the memory that was requested to be deleted */
-    id: string;
-}
-/**
- * Delete a memory by ID from Memoria.
- */
-export declare function executeForget(input: ForgetInput, ctx: ToolContext): Promise<ToolResult>;
-export interface DiscoverInput {
-    /** Topic to search for */
-    topic: string;
-    /** Maximum number of items to retrieve (default: 10) */
-    limit?: number;
-    /** Kind of items to filter by (tool, skill) */
-    kind?: "tool" | "skill";
-}
-export interface DiscoverOutput {
-    /** Retrieved tool items */
-    tools: ToolItem[];
-    /** Retrieved skill items */
-    skills: SkillItem[];
-    /** Number of tools found */
-    toolCount: number;
-    /** Number of skills found */
-    skillCount: number;
-    /** Generated insights based on the results */
-    insights: string[];
-}
-/**
- * Discover tools and skills by topic.
- *
- * Calls recallTools() and recallSkills() on Memoria directly,
- * returning separate arrays (no merging or conversion needed).
- * When input.kind is set, only the relevant API is called.
- */
-export declare function executeDiscover(input: DiscoverInput, ctx: ToolContext): Promise<ToolResult>;
-export interface ReflectInput {
-    /** Summary of what happened in the conversation — what you did, what worked, what didn't */
-    summary: string;
-}
-export interface ReflectOutput {
-    /** Whether anything genuinely new was learned */
-    learned: boolean;
-    /** The observation stored, if any */
-    observation: string | null;
-    /** Skill candidate discovered during the conversation, if any */
-    skillCandidate?: {
-        name: string;
-        level: string;
-        description: string;
-    } | null;
-}
-/**
- * Trigger self-reflection on the current conversation.
- * Calls the router to identify genuine learnings (limitations,
- * non-obvious strategies, user preferences, blind spots).
- * Stores observations to the beliefs network when found.
- */
-export declare function executeReflect(input: ReflectInput, ctx: ToolContext): Promise<ToolResult>;
-export {};

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