@aria-cli/tools 1.0.0

package/dist/executors/pty.js

@@ -0,0 +1,272 @@
+/**
+ * @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";
+import { sanitizeEnv } from "./shell.js";
+/**
+ * Error thrown when a PTY operation times out.
+ */
+export class PTYTimeoutError extends Error {
+    output;
+    constructor(message, output) {
+        super(message);
+        this.output = output;
+        this.name = "PTYTimeoutError";
+    }
+}
+/**
+ * Error thrown when a PTY operation fails.
+ */
+export class PTYError extends Error {
+    output;
+    constructor(message, output) {
+        super(message);
+        this.output = output;
+        this.name = "PTYError";
+    }
+}
+/**
+ * A session wrapping a PTY process.
+ * Provides methods for interacting with the process and collecting output.
+ */
+export class PTYSession {
+    static MAX_OUTPUT = 10 * 1024 * 1024; // 10MB
+    _output = "";
+    _isRunning = true;
+    _exitCode;
+    _exitPromise;
+    _exitResolve;
+    _pty;
+    _dataDisposable;
+    _exitDisposable;
+    constructor(pty) {
+        this._pty = pty;
+        // Set up exit promise
+        this._exitPromise = new Promise((resolve) => {
+            this._exitResolve = resolve;
+        });
+        // Collect output with buffer cap
+        this._dataDisposable = pty.onData((data) => {
+            this._output += data;
+            if (this._output.length > PTYSession.MAX_OUTPUT) {
+                this._output = this._output.slice(-PTYSession.MAX_OUTPUT);
+            }
+        });
+        // Handle exit
+        this._exitDisposable = pty.onExit(({ exitCode }) => {
+            this._isRunning = false;
+            this._exitCode = exitCode;
+            this._exitResolve(exitCode);
+        });
+    }
+    /**
+     * Write data to the terminal input.
+     */
+    write(data) {
+        if (!this._isRunning) {
+            throw new PTYError("Cannot write to a closed PTY session");
+        }
+        this._pty.write(data);
+    }
+    /**
+     * Resize the terminal.
+     */
+    resize(cols, rows) {
+        if (!this._isRunning) {
+            throw new PTYError("Cannot resize a closed PTY session");
+        }
+        this._pty.resize(cols, rows);
+    }
+    /**
+     * 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
+     */
+    async waitFor(pattern, timeoutMs = 5000) {
+        const startTime = Date.now();
+        const regex = typeof pattern === "string" ? new RegExp(escapeRegExp(pattern)) : pattern;
+        // Check if pattern already matches
+        if (regex.test(this._output)) {
+            return this._output;
+        }
+        return new Promise((resolve, reject) => {
+            let checkInterval;
+            let timeoutHandle;
+            const cleanup = () => {
+                if (checkInterval)
+                    clearInterval(checkInterval);
+                if (timeoutHandle)
+                    clearTimeout(timeoutHandle);
+            };
+            const check = () => {
+                if (regex.test(this._output)) {
+                    cleanup();
+                    resolve(this._output);
+                    return true;
+                }
+                if (!this._isRunning) {
+                    cleanup();
+                    reject(new PTYError(`Process exited before pattern was found: ${pattern}`, this._output));
+                    return true;
+                }
+                return false;
+            };
+            // Initial check
+            if (check())
+                return;
+            // Set up polling
+            checkInterval = setInterval(() => {
+                check();
+            }, 10);
+            // Set up timeout
+            timeoutHandle = setTimeout(() => {
+                cleanup();
+                const elapsed = Date.now() - startTime;
+                reject(new PTYTimeoutError(`Timeout (${elapsed}ms) waiting for pattern: ${pattern}`, this._output));
+            }, timeoutMs);
+        });
+    }
+    /**
+     * Wait for the process to exit.
+     * @param timeoutMs Timeout in milliseconds (default: 30000)
+     * @returns The complete output
+     */
+    async waitForExit(timeoutMs = 30000) {
+        if (!this._isRunning) {
+            return this._output;
+        }
+        return new Promise((resolve, reject) => {
+            let timeoutHandle;
+            timeoutHandle = setTimeout(() => {
+                reject(new PTYTimeoutError(`Timeout (${timeoutMs}ms) waiting for process to exit`, this._output));
+            }, timeoutMs);
+            this._exitPromise
+                .then(() => {
+                if (timeoutHandle)
+                    clearTimeout(timeoutHandle);
+                resolve(this._output);
+            })
+                .catch(reject);
+        });
+    }
+    /**
+     * Kill the process.
+     * @param signal Signal to send (default: SIGHUP on Unix)
+     */
+    kill(signal) {
+        if (!this._isRunning) {
+            return;
+        }
+        try {
+            this._pty.kill(signal);
+        }
+        catch {
+            // Process may already be dead
+        }
+    }
+    /**
+     * Close the session and clean up resources.
+     */
+    close() {
+        // Kill the process first before disposing handlers
+        if (this._isRunning) {
+            this.kill("SIGKILL");
+            // Mark as not running since we won't receive the exit event
+            // after disposing the handlers
+            this._isRunning = false;
+            // Resolve the exit promise to unblock any waiters
+            // Use -1 to indicate forced termination
+            this._exitResolve(-1);
+        }
+        this._dataDisposable.dispose();
+        this._exitDisposable.dispose();
+    }
+    /**
+     * Get the current output buffer.
+     */
+    get output() {
+        return this._output;
+    }
+    /**
+     * Check if the process is still running.
+     */
+    get isRunning() {
+        return this._isRunning;
+    }
+    /**
+     * Get the process ID.
+     */
+    get pid() {
+        return this._pty.pid;
+    }
+    /**
+     * Get the exit code (undefined if still running).
+     */
+    get exitCode() {
+        return this._exitCode;
+    }
+    /**
+     * Get the current terminal columns.
+     */
+    get cols() {
+        return this._pty.cols;
+    }
+    /**
+     * Get the current terminal rows.
+     */
+    get rows() {
+        return this._pty.rows;
+    }
+}
+/**
+ * Create a new PTY session.
+ * @param options Options for the PTY
+ * @returns A PTYSession wrapping the process
+ */
+export async function createPTYSession(options) {
+    const defaultCols = 80;
+    const defaultRows = 24;
+    const pty = nodePty.spawn(options.command, options.args ?? [], {
+        name: "xterm-256color",
+        cols: options.cols ?? defaultCols,
+        rows: options.rows ?? defaultRows,
+        cwd: options.cwd ?? process.cwd(),
+        env: {
+            ...sanitizeEnv(options.env),
+            TERM: "xterm-256color",
+        },
+    });
+    return new PTYSession(pty);
+}
+/**
+ * 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 async function runInPTY(options) {
+    const { timeoutMs = 30000, ...ptyOptions } = options;
+    const session = await createPTYSession(ptyOptions);
+    try {
+        const output = await session.waitForExit(timeoutMs);
+        return {
+            output,
+            exitCode: session.exitCode ?? 0,
+        };
+    }
+    finally {
+        session.close();
+    }
+}
+/**
+ * Escape special regex characters in a string.
+ */
+function escapeRegExp(string) {
+    return string.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+}
+//# sourceMappingURL=pty.js.map

package/dist/executors/pty.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pty.js","sourceRoot":"","sources":["../../src/executors/pty.ts"],"names":[],"mappings":"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"}

package/dist/executors/restart.d.ts

@@ -0,0 +1,19 @@
+/**
+ * @aria/tools - Restart executor
+ *
+ * Two restart paths:
+ *
+ * 1. Supervised (TUI via relaunch.ts): ARIA_NO_RELAUNCH=true is set by the
+ *    parent supervisor. Child exits with RELAUNCH_EXIT_CODE (199), parent
+ *    respawns automatically.
+ *
+ * 2. Daemon (daemon-launcher): No supervisor loop. The executor spawns a
+ *    replacement daemon on the process 'exit' event (after the singleton lock
+ *    is released), then sends SIGINT to trigger graceful shutdown.
+ */
+import type { ToolContext, ToolResult } from "../types.js";
+export interface RestartInput {
+    reason?: string;
+}
+export declare function executeRestart(input: RestartInput, ctx: ToolContext): Promise<ToolResult>;
+//# sourceMappingURL=restart.d.ts.map

package/dist/executors/restart.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"restart.d.ts","sourceRoot":"","sources":["../../src/executors/restart.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAc3D,MAAM,WAAW,YAAY;IAC3B,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AA+DD,wBAAsB,cAAc,CAAC,KAAK,EAAE,YAAY,EAAE,GAAG,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC,CA0E/F"}

package/dist/executors/restart.js

@@ -0,0 +1,151 @@
+/**
+ * @aria/tools - Restart executor
+ *
+ * Two restart paths:
+ *
+ * 1. Supervised (TUI via relaunch.ts): ARIA_NO_RELAUNCH=true is set by the
+ *    parent supervisor. Child exits with RELAUNCH_EXIT_CODE (199), parent
+ *    respawns automatically.
+ *
+ * 2. Daemon (daemon-launcher): No supervisor loop. The executor spawns a
+ *    replacement daemon on the process 'exit' event (after the singleton lock
+ *    is released), then sends SIGINT to trigger graceful shutdown.
+ */
+import { success, fail } from "./utils.js";
+import { spawn } from "node:child_process";
+import { existsSync, readdirSync, readFileSync } from "node:fs";
+import { dirname, join, resolve } from "node:path";
+import * as os from "node:os";
+import { NO_RELAUNCH_ENV, RELAUNCH_EXIT_CODE, RESUME_ARION_ENV, RESUME_SESSION_ENV, writeRelaunchMarker, } from "@aria/types";
+function findPnpmWorkspaceRoot(startDir) {
+    let dir = resolve(startDir);
+    while (true) {
+        if (existsSync(join(dir, "pnpm-workspace.yaml")))
+            return dir;
+        const parent = dirname(dir);
+        if (parent === dir)
+            return null;
+        dir = parent;
+    }
+}
+function getPnpmCommand() {
+    return process.platform === "win32" ? "pnpm.cmd" : "pnpm";
+}
+async function rebuildWorkspaceIfPresent(startDir) {
+    const root = findPnpmWorkspaceRoot(startDir);
+    if (!root)
+        return { attempted: false };
+    const pnpm = getPnpmCommand();
+    await new Promise((resolvePromise, rejectPromise) => {
+        const child = spawn(pnpm, ["build"], {
+            cwd: root,
+            env: process.env,
+            stdio: "inherit",
+        });
+        child.on("error", rejectPromise);
+        child.on("close", (code) => {
+            if (code === 0)
+                resolvePromise();
+            else
+                rejectPromise(new Error(`pnpm build failed with exit code ${code ?? "unknown"}`));
+        });
+    });
+    return { attempted: true };
+}
+/**
+ * Find the daemon PID for the current ARIA_HOME by scanning owner records.
+ * Owner records live at $RUNTIME_ROOT/owners/*.json where RUNTIME_ROOT is
+ * XDG_RUNTIME_DIR/aria or ~/.aria/run.
+ */
+function findDaemonPid() {
+    const ariaHome = process.env.ARIA_HOME?.trim() || join(os.homedir(), ".aria");
+    const runtimeDir = process.env.XDG_RUNTIME_DIR?.trim();
+    const runtimeRoot = runtimeDir ? join(runtimeDir, "aria") : join(ariaHome, "run");
+    const ownersDir = join(runtimeRoot, "owners");
+    if (!existsSync(ownersDir))
+        return null;
+    const canonicalHome = resolve(ariaHome);
+    for (const file of readdirSync(ownersDir).filter((f) => f.endsWith(".json"))) {
+        try {
+            const record = JSON.parse(readFileSync(join(ownersDir, file), "utf8"));
+            if (record.ariaHome && resolve(record.ariaHome) === canonicalHome) {
+                return typeof record.runtimePid === "number" ? record.runtimePid : null;
+            }
+        }
+        catch {
+            // Skip malformed records
+        }
+    }
+    return null;
+}
+export async function executeRestart(input, ctx) {
+    if (ctx.abortSignal?.aborted)
+        return fail("Operation cancelled");
+    const supervised = process.env[NO_RELAUNCH_ENV] === "true";
+    const reason = (input.reason ?? "").trim() || "Restart requested";
+    // Note: tool definition has requiresConfirmation: true, so the framework
+    // already prompts the user before execute() is called. No need to confirm again.
+    process.stderr.write(`[aria] Rebuilding workspace before restart...\n`);
+    try {
+        const rebuilt = await rebuildWorkspaceIfPresent(ctx.workingDir || process.cwd());
+        if (!rebuilt.attempted) {
+            process.stderr.write(`[aria] No pnpm workspace detected; skipping build\n`);
+        }
+    }
+    catch (error) {
+        process.stderr.write(`[aria] Build failed; continuing restart: ${error.message}\n`);
+    }
+    process.stderr.write(`[aria] Restarting: ${reason}\n`);
+    const sessionId = process.env[RESUME_SESSION_ENV] ?? null;
+    const arionName = process.env[RESUME_ARION_ENV] || "ARIA";
+    // Write disk-backed marker as durable fallback in case IPC is lost.
+    writeRelaunchMarker({
+        sessionId,
+        arionName,
+        pid: process.ppid || process.pid,
+        timestamp: new Date().toISOString(),
+    });
+    if (supervised) {
+        // Path 1: Supervised by parent-child relaunch loop (TUI mode).
+        // Pass session forward via IPC, then exit with magic code for parent to respawn.
+        try {
+            const send = process.send;
+            if (typeof send === "function") {
+                send({
+                    type: "aria-relaunch",
+                    resumeSessionId: sessionId,
+                    arionName,
+                });
+            }
+        }
+        catch {
+            // non-fatal — disk marker is the fallback
+        }
+        process.exit(RELAUNCH_EXIT_CODE);
+    }
+    else {
+        // Path 2: Daemon mode — no supervisor loop.
+        // Register an 'exit' handler to spawn the replacement AFTER the singleton
+        // lock is released (beforeExit releases it). Then SIGINT ourselves to
+        // trigger graceful daemon shutdown. The SIGINT handler fires synchronously
+        // (just sets controller.abort()), so the tool can still return success.
+        const daemonPid = findDaemonPid() ?? process.pid;
+        process.once("exit", () => {
+            spawn(process.execPath, [...process.execArgv, ...process.argv.slice(1)], {
+                detached: true,
+                stdio: "ignore",
+            }).unref();
+        });
+        process.stderr.write(`[aria] Sending SIGINT to daemon pid ${daemonPid} for graceful restart\n`);
+        try {
+            process.kill(daemonPid, "SIGINT");
+        }
+        catch {
+            // PID already dead or not our process — fall back to self
+            process.kill(process.pid, "SIGINT");
+        }
+    }
+    // Unreachable in supervised path (process.exit above), but returned in daemon path
+    return success("Restarting...");
+}
+//# sourceMappingURL=restart.js.map

package/dist/executors/restart.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"restart.js","sourceRoot":"","sources":["../../src/executors/restart.ts"],"names":[],"mappings":"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"}

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

@@ -0,0 +1,53 @@
+/**
+ * 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[];
+//# sourceMappingURL=search-types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"search-types.d.ts","sourceRoot":"","sources":["../../src/executors/search-types.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,oEAAoE;AACpE,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,GAAG,OAAO,GAAG,QAAQ,CAAC;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EACF,SAAS,GACT,OAAO,GACP,WAAW,GACX,SAAS,GACT,WAAW,GACX,SAAS,GACT,KAAK,GACL,MAAM,GACN,KAAK,CAAC;IACV,QAAQ,EAAE,OAAO,CAAC;IAClB,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,YAAY,GAAG,SAAS,GAAG,QAAQ,CAAC;IAC9D,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,8EAA8E;IAC9E,OAAO,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAC;QAAC,UAAU,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC;CACvE;AAED,gEAAgE;AAChE,MAAM,WAAW,SAAS;IACxB,EAAE,EAAE,OAAO,GAAG,OAAO,GAAG,SAAS,CAAC;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,yCAAyC;AACzC,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,KAAK,CAAC,SAAS,GAAG,OAAO,GAAG,WAAW,GAAG,SAAS,GAAG,UAAU,GAAG,KAAK,CAAC,CAAC;IACpF,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB;AAMD,2DAA2D;AAC3D,eAAO,MAAM,eAAe,EAAE,MAAM,CAAC,YAAY,CAAC,QAAQ,CAAC,EAAE,MAAM,CAUlE,CAAC;AAEF;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,YAAY,EAAE,EAAE,KAAK,EAAE,MAAM,GAAG,YAAY,EAAE,CAsBzF"}

package/dist/executors/search-types.js

@@ -0,0 +1,53 @@
+/**
+ * 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
+ */
+// ---------------------------------------------------------------------------
+// Shared dedup logic — single source of truth for both base executor and wrapper
+// ---------------------------------------------------------------------------
+/** Source priority for dedup (lower = higher priority). */
+export const SOURCE_PRIORITY = {
+    builtin: 0,
+    local_cli: 1,
+    memoria: 2,
+    local: 3,
+    "skills.sh": 4,
+    clawhub: 5,
+    npm: 6,
+    brew: 7,
+    web: 8,
+};
+/**
+ * Dedup search results by name with source priority.
+ * When the same name appears from multiple sources, keep the higher-priority one.
+ */
+export function dedupSearchResults(results, limit) {
+    const deduped = new Map();
+    for (const item of results) {
+        const normalizedName = item.name.trim().toLowerCase();
+        const existing = deduped.get(normalizedName);
+        if (!existing) {
+            deduped.set(normalizedName, item);
+        }
+        else {
+            const existingPriority = SOURCE_PRIORITY[existing.source] ?? 99;
+            const newPriority = SOURCE_PRIORITY[item.source] ?? 99;
+            if (newPriority < existingPriority) {
+                deduped.set(normalizedName, item);
+            }
+        }
+    }
+    const sorted = [...deduped.values()].sort((a, b) => {
+        const aPriority = SOURCE_PRIORITY[a.source] ?? 99;
+        const bPriority = SOURCE_PRIORITY[b.source] ?? 99;
+        if (aPriority !== bPriority)
+            return aPriority - bPriority;
+        return a.name.localeCompare(b.name);
+    });
+    return sorted.slice(0, limit);
+}
+//# sourceMappingURL=search-types.js.map

package/dist/executors/search-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"search-types.js","sourceRoot":"","sources":["../../src/executors/search-types.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AA+CH,8EAA8E;AAC9E,iFAAiF;AACjF,8EAA8E;AAE9E,2DAA2D;AAC3D,MAAM,CAAC,MAAM,eAAe,GAA2C;IACrE,OAAO,EAAE,CAAC;IACV,SAAS,EAAE,CAAC;IACZ,OAAO,EAAE,CAAC;IACV,KAAK,EAAE,CAAC;IACR,WAAW,EAAE,CAAC;IACd,OAAO,EAAE,CAAC;IACV,GAAG,EAAE,CAAC;IACN,IAAI,EAAE,CAAC;IACP,GAAG,EAAE,CAAC;CACP,CAAC;AAEF;;;GAGG;AACH,MAAM,UAAU,kBAAkB,CAAC,OAAuB,EAAE,KAAa;IACvE,MAAM,OAAO,GAAG,IAAI,GAAG,EAAwB,CAAC;IAChD,KAAK,MAAM,IAAI,IAAI,OAAO,EAAE,CAAC;QAC3B,MAAM,cAAc,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;QACtD,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC;QAC7C,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,OAAO,CAAC,GAAG,CAAC,cAAc,EAAE,IAAI,CAAC,CAAC;QACpC,CAAC;aAAM,CAAC;YACN,MAAM,gBAAgB,GAAG,eAAe,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;YAChE,MAAM,WAAW,GAAG,eAAe,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;YACvD,IAAI,WAAW,GAAG,gBAAgB,EAAE,CAAC;gBACnC,OAAO,CAAC,GAAG,CAAC,cAAc,EAAE,IAAI,CAAC,CAAC;YACpC,CAAC;QACH,CAAC;IACH,CAAC;IACD,MAAM,MAAM,GAAG,CAAC,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;QACjD,MAAM,SAAS,GAAG,eAAe,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;QAClD,MAAM,SAAS,GAAG,eAAe,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;QAClD,IAAI,SAAS,KAAK,SAAS;YAAE,OAAO,SAAS,GAAG,SAAS,CAAC;QAC1D,OAAO,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;IACtC,CAAC,CAAC,CAAC;IACH,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;AAChC,CAAC"}

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

@@ -0,0 +1,90 @@
+/**
+ * @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>;
+//# sourceMappingURL=self-diagnose.d.ts.map