@aria-cli/tools 1.0.10 → 1.0.12

package/dist-cjs/executors/frg.js

@@ -0,0 +1,334 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.executeFrg = executeFrg;
+const fsSync = __importStar(require("node:fs"));
+const nodePath = __importStar(require("node:path"));
+const fastripgrep_1 = require("@aria-cli/fastripgrep");
+const utils_js_1 = require("./utils.js");
+const shell_js_1 = require("./shell.js");
+const frg_freshness_js_1 = require("./frg-freshness.js");
+function resolveSearchRoot(inputPath, ctx) {
+    const requested = inputPath ?? ".";
+    return nodePath.isAbsolute(requested)
+        ? nodePath.resolve(requested)
+        : nodePath.resolve(ctx.workingDir, requested);
+}
+function assertAllowedPath(resolvedPath, ctx) {
+    let realBase = nodePath.resolve(ctx.workingDir);
+    try {
+        realBase = fsSync.realpathSync(ctx.workingDir);
+    }
+    catch {
+        // ignore
+    }
+    let candidate = resolvedPath;
+    try {
+        candidate = fsSync.realpathSync(resolvedPath);
+    }
+    catch {
+        candidate = nodePath.resolve(resolvedPath);
+    }
+    if ((0, utils_js_1.isPathWithinBase)(candidate, realBase)) {
+        return;
+    }
+    const home = process.env.HOME;
+    if (home) {
+        try {
+            const realHome = fsSync.realpathSync(home);
+            if ((0, utils_js_1.isPathWithinBase)(candidate, realHome)) {
+                return;
+            }
+        }
+        catch {
+            // ignore
+        }
+    }
+    throw new Error("Path traversal not allowed: resolved path is outside working directory and home directory");
+}
+function toNativeInput(input, root) {
+    return {
+        command: input.command,
+        pattern: input.pattern,
+        replacement: input.replacement,
+        path: root,
+        noIndex: input.noIndex,
+        literal: input.literal,
+        caseInsensitive: input.caseInsensitive,
+        smartCase: input.smartCase,
+        filesOnly: input.filesOnly,
+        count: input.count,
+        maxCount: input.maxCount,
+        quiet: input.quiet,
+        context: input.context,
+        json: input.json,
+        glob: input.glob,
+        fileType: input.fileType,
+        follow: input.follow,
+        extraPatterns: input.extraPatterns,
+        maxFilesize: input.maxFilesize,
+        force: input.force,
+        write: input.write,
+        hook: input.hook,
+        shell: input.shell,
+    };
+}
+function getNativeSessionOverlay(root) {
+    const sessionWrites = [];
+    const sessionDeletes = [];
+    for (const mutation of (0, frg_freshness_js_1.getPendingFrgMutations)(root)) {
+        if (mutation.operation === "delete") {
+            sessionDeletes.push(nodePath.resolve(mutation.path));
+            continue;
+        }
+        // Read content from disk if not cached. This closes the gap where
+        // reconcileGitDirtyMutations detects git-dirty files but sets
+        // content=undefined (no cache). Without this read, the session overlay
+        // would skip these mutations entirely — making agent-written files
+        // invisible until the 750ms background flush completes.
+        let content = mutation.content;
+        if (typeof content !== "string") {
+            try {
+                const resolved = nodePath.resolve(mutation.path);
+                const buf = fsSync.readFileSync(resolved);
+                // Skip binary files
+                if (!buf.subarray(0, Math.min(buf.length, 8192)).includes(0)) {
+                    content = buf.toString("utf8");
+                }
+            }
+            catch {
+                // File unreadable (deleted, permission, etc.) — skip
+            }
+        }
+        if (typeof content === "string") {
+            sessionWrites.push({
+                path: nodePath.resolve(mutation.path),
+                content,
+            });
+        }
+    }
+    return { sessionWrites, sessionDeletes };
+}
+async function executeFrgWatch(_input, ctx, root) {
+    const resolvedWorkingDir = nodePath.resolve(ctx.workingDir);
+    const repoRoot = resolvedWorkingDir.includes(`${nodePath.sep}packages${nodePath.sep}`)
+        ? (resolvedWorkingDir.split(`${nodePath.sep}packages${nodePath.sep}`)[0] ?? process.cwd())
+        : process.cwd();
+    const binaryPath = nodePath.join(repoRoot, "vendor", "fastripgrep", "target", "release", process.platform === "win32" ? "frg.exe" : "frg");
+    if (!fsSync.existsSync(binaryPath)) {
+        return (0, utils_js_1.fail)(`frg watch failed: binary not found at ${binaryPath}. Build @aria-cli/fastripgrep first.`);
+    }
+    const spawnResult = await (0, shell_js_1.executeSpawn)({
+        program: binaryPath,
+        args: ["watch", root],
+        cwd: root,
+    }, ctx);
+    if (!spawnResult.success) {
+        return spawnResult;
+    }
+    const data = (spawnResult.data ?? {});
+    return (0, utils_js_1.success)(`Started frg watch process for ${root}`, {
+        command: "watch",
+        path: root,
+        watched: true,
+        pid: data.pid,
+    });
+}
+function maybeReindexOnHeadChange(root, currentOutput) {
+    if (currentOutput.command !== "status") {
+        return currentOutput;
+    }
+    try {
+        const indexedTree = currentOutput.status?.tree_hash ?? null;
+        const indexedHead = currentOutput.status?.commit_hash ?? null;
+        const freshness = (0, frg_freshness_js_1.getFrgFreshnessSnapshot)(root, currentOutput.status);
+        if (freshness.headTree && indexedTree && freshness.headTree !== indexedTree) {
+            if (freshness.sessionPendingCount === 0 &&
+                freshness.dirtyTrackedCount === 0 &&
+                freshness.dirtyUntrackedCount === 0) {
+                const updated = (0, fastripgrep_1.frg)({ command: "update", path: root });
+                return {
+                    ...updated,
+                    content: `HEAD tree changed from indexed ${indexedTree} to ${freshness.headTree}; triggered incremental update`,
+                };
+            }
+            return {
+                ...currentOutput,
+                content: `HEAD tree differs from indexed tree (${indexedTree} -> ${freshness.headTree}); local dirty state deferred update`,
+            };
+        }
+        if (indexedHead && freshness.headCommit && indexedHead !== freshness.headCommit) {
+            return {
+                ...currentOutput,
+                content: `HEAD commit differs from indexed commit (${indexedHead} -> ${freshness.headCommit})`,
+            };
+        }
+    }
+    catch {
+        // ignore and keep status output stable
+    }
+    return currentOutput;
+}
+function enrichStatusOutput(root, output) {
+    if (output.command !== "status") {
+        return output;
+    }
+    const freshness = (0, frg_freshness_js_1.getFrgFreshnessSnapshot)(root, output.status);
+    return {
+        ...output,
+        status: output.status
+            ? {
+                ...output.status,
+                head_commit: freshness.headCommit,
+                head_tree: freshness.headTree,
+                tree_match: freshness.headTree && output.status.tree_hash
+                    ? freshness.headTree === output.status.tree_hash
+                    : undefined,
+                dirty_tracked_count: freshness.dirtyTrackedCount,
+                dirty_untracked_count: freshness.dirtyUntrackedCount,
+                session_pending_count: freshness.sessionPendingCount,
+                session_pending_bytes: freshness.sessionPendingBytes,
+                background_flush_scheduled: freshness.flush.scheduled,
+                flush_in_flight: freshness.flush.inFlight,
+                last_flush_at: freshness.flush.lastFlushAt,
+                last_flush_error: freshness.flush.lastError,
+                freshness_state: freshness.freshnessState,
+            }
+            : output.status,
+    };
+}
+function messageFor(output, input) {
+    if (output.command === "search") {
+        if (output.mode === "quiet") {
+            return output.matched
+                ? `Match found for ${input.pattern}`
+                : `No matches found for ${input.pattern}`;
+        }
+        if (output.mode === "files") {
+            return `Found ${(output.files ?? []).length} files for ${input.pattern}`;
+        }
+        if (output.mode === "counts") {
+            return `Counted matches in ${(output.counts ?? []).length} files for ${input.pattern}`;
+        }
+        return `Found ${(output.matches ?? []).length} matches for ${input.pattern}`;
+    }
+    if (output.command === "replace") {
+        return input.write
+            ? `Applied ${output.replacements ?? 0} replacements in ${output.files_changed ?? 0} files`
+            : `Previewed ${output.replacements ?? 0} replacements in ${output.files_changed ?? 0} files`;
+    }
+    if (output.command === "init") {
+        return output.hook_installed
+            ? `Initialized frg for ${output.path} and installed git hook`
+            : `Initialized frg for ${output.path}`;
+    }
+    if (output.command === "completions") {
+        return `Generated ${output.shell ?? input.shell ?? "shell"} completions for frg`;
+    }
+    if (output.command === "man") {
+        return "Generated frg man page content";
+    }
+    if (output.command === "upgrade") {
+        return output.content ?? "Provided frg upgrade metadata";
+    }
+    return `frg ${output.command} completed for ${output.path}`;
+}
+async function executeFrg(input, ctx) {
+    try {
+        const args = input;
+        const root = resolveSearchRoot(args.path, ctx);
+        assertAllowedPath(root, ctx);
+        if (args.command === "watch") {
+            return executeFrgWatch(args, ctx, root);
+        }
+        (0, frg_freshness_js_1.ensureFrgRepoStateLoaded)(root);
+        (0, frg_freshness_js_1.reconcileGitDirtyMutations)(root);
+        if (args.command === "search") {
+            (0, frg_freshness_js_1.maybeBuildFrgIndexForRepo)(root);
+            // Detect HEAD tree change (e.g., after a commit or branch switch).
+            // Without this, the index stays on the old tree until `frg status` is
+            // explicitly called. This is the same gap that aria-search had —
+            // the index was "ready" because .frg/ exists, but stale because
+            // the tree changed. Run incremental update to pick up the new tree.
+            try {
+                const statusOutput = (0, fastripgrep_1.frg)({ command: "status", path: root });
+                if (statusOutput.status?.tree_hash && statusOutput.status?.commit_hash) {
+                    const snapshot = (0, frg_freshness_js_1.getFrgFreshnessSnapshot)(root, statusOutput.status);
+                    if (snapshot.headTree &&
+                        statusOutput.status.tree_hash !== snapshot.headTree &&
+                        snapshot.sessionPendingCount === 0 &&
+                        snapshot.dirtyTrackedCount === 0 &&
+                        snapshot.dirtyUntrackedCount === 0) {
+                        // Clean working tree but HEAD moved — incremental update
+                        (0, fastripgrep_1.frg)({ command: "update", path: root });
+                        (0, frg_freshness_js_1.clearPendingFrgMutations)(root);
+                    }
+                }
+            }
+            catch {
+                // Best effort — search will still work with session overlay
+            }
+            const pending = (0, frg_freshness_js_1.getPendingFrgMutations)(root);
+            if (pending.length > 0) {
+                if (!args.noIndex) {
+                    if ((0, frg_freshness_js_1.shouldForceSynchronousFrgFlush)(root)) {
+                        (0, frg_freshness_js_1.flushPendingFrgMutations)(root);
+                    }
+                    else {
+                        (0, frg_freshness_js_1.scheduleBackgroundFrgFlush)(root);
+                    }
+                }
+            }
+        }
+        const nativeInput = toNativeInput(args, root);
+        if (args.command === "search") {
+            const sessionOverlay = getNativeSessionOverlay(root);
+            nativeInput.sessionWrites = sessionOverlay.sessionWrites;
+            nativeInput.sessionDeletes = sessionOverlay.sessionDeletes;
+        }
+        let output = (0, fastripgrep_1.frg)(nativeInput);
+        if (args.command === "status") {
+            output = maybeReindexOnHeadChange(root, output);
+            output = enrichStatusOutput(root, output);
+            if (output.content?.includes("triggered incremental update")) {
+                (0, frg_freshness_js_1.clearPendingFrgMutations)(root);
+            }
+        }
+        return (0, utils_js_1.success)(messageFor(output, args), output);
+    }
+    catch (error) {
+        return (0, utils_js_1.fail)(`frg failed: ${(0, utils_js_1.getErrorMessage)(error)}`);
+    }
+}

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

@@ -0,0 +1,44 @@
+/**
+ * @aria/tools - Tool executors
+ *
+ * Executor functions that implement actual tool functionality.
+ */
+export { executeReadFile, executeWriteFile, executeEditFile, executeLs, executeGlob, executeGrep, } from "./filesystem.js";
+export type { ReadFileInput, WriteFileInput, EditFileInput, ListDirInput, ListDirEntry, ListDirOutput, LsInput, LsEntry, GlobInput, GrepInput, GrepMatch, } from "./filesystem.js";
+export { executeFrg } from "./frg.js";
+export { recordFrgMutation, getPendingFrgMutations, getPendingFrgMutationBytes, clearPendingFrgMutations, flushPendingFrgMutations, maybeBuildFrgIndexForRepo, ensureFrgRepoStateLoaded, reconcileGitDirtyMutations, getGitDirtyStatus, getFrgFlushStatus, getFrgFreshnessSnapshot, scheduleBackgroundFrgFlush, shouldForceSynchronousFrgFlush, DEFAULT_BACKGROUND_FRG_FLUSH_DELAY_MS, BACKGROUND_FRG_MAX_FLUSH_DELAY_MS, MAX_PENDING_MUTATIONS_BEFORE_SYNC_FLUSH, MAX_PENDING_MUTATION_BYTES_BEFORE_SYNC_FLUSH, MAX_CACHED_MUTATION_CONTENT_BYTES, } from "./frg-freshness.js";
+export type { FrgInput } from "./frg.js";
+export type { FrgMutationOperation, FrgMutationRecord, FrgGitDirtyStatus, FrgFlushStatus, FrgFreshnessSnapshot, } from "./frg-freshness.js";
+export { executeApplyPatch } from "./apply-patch.js";
+export type { ApplyPatchInput } from "./apply-patch.js";
+export { executeBash, executeExec, executeSpawn, executeKill, executeListProcesses, executeWaitProcess, executeWriteStdin, sanitizeGitEnv, sanitizeEnv, } from "./shell.js";
+export { classifyCommand, BLOCKED_PATTERNS as SHELL_BLOCKED_PATTERNS } from "./shell-safety.js";
+export type { BashInput, BashOutput, ExecInput, ExecOutput, SpawnInput, SpawnOutput, KillInput, KillOutput, ListProcessesInput, ListProcessesOutput, WaitProcessInput, WaitProcessOutput, WriteStdinInput, WriteStdinOutput, } from "./shell.js";
+export { executeRemember, executeRecall, executeForget, executeDiscover, executeReflect, getConversationContext, getSessionTranscript, getSelfContext, } from "./memory.js";
+export type { RememberInput, RememberOutput, RecallInput, RecallOutput, ForgetInput, ForgetOutput, DiscoverInput, DiscoverOutput, ReflectInput, ReflectOutput, RecallToolContext, } from "./memory.js";
+export { executeWebSearch, executeWebFetch, executeBrowse } from "./web.js";
+export type { WebSearchInput, WebSearchOutput, WebFetchInput, WebFetchOutput, BrowseInput, BrowseOutput, } from "./web.js";
+export { PTYSession, PTYTimeoutError, PTYError, createPTYSession, runInPTY } from "./pty.js";
+export type { PTYOptions, PTYResult } from "./pty.js";
+export { PTYSessionStore } from "./pty-session-store.js";
+export { executeHatchArion, executeRestArion, executeWakeArion, executeRetireArion, } from "./arion.js";
+export type { HatchArionInput, HatchArionOutput, RestArionInput, WakeArionInput, RetireArionInput, } from "./arion.js";
+export { SpawnedProcessRegistry } from "./process-registry.js";
+export type { TrackedProcessMetadata, ProcessExitMetadata, ProcessInfoSnapshot, ProcessWaitResult, } from "./process-registry.js";
+export { executeAskUser, executeQuestUpdate, executeQuestList, resetAskUserCounter, } from "./meta.js";
+export { executeSearchKnowledge, executeLearnTool, executeLearnSkill, executeLearnLegacy, executeCreateTool, executeCreateSkill, executeUseSkill, searchMemoria, searchLocalSkills, searchSkillRegistries, searchWeb, getOSContext, settleWithDeadline, fetchJson, } from "./learning-meta.js";
+export type { AskUserInput, QuestUpdateInput, QuestUpdateOutput, QuestListInput, QuestListOutput, } from "./meta.js";
+export type { SearchKnowledgeInput, LearnToolInput, LearnSkillInput, LearnLegacyInput, CreateToolInput, CreateSkillInput, UseSkillInput, } from "./learning-meta.js";
+export type { SearchResult, OSContext, SearchInput } from "./search-types.js";
+export { SOURCE_PRIORITY, dedupSearchResults } from "./search-types.js";
+export { executeSessionHistory } from "./session-history.js";
+export type { SessionHistoryInput, SessionHistoryAction, SessionListOutput, SessionGetOutput, SessionCurrentOutput, SessionStatsOutput, } from "./session-history.js";
+export { executeSelfDiagnose } from "./self-diagnose.js";
+export type { SelfDiagnoseInput, SelfDiagnoseOutput } from "./self-diagnose.js";
+export { executeRestart } from "./restart.js";
+export type { RestartInput } from "./restart.js";
+export { executeDeploy } from "./deploy.js";
+export type { DeployInput, DeployOutput } from "./deploy.js";
+export { executeRg, executeUg, executeProbe, executeSg, executeCbm, executeLsp, executeSerena, executeFff, } from "./code-intelligence.js";
+export type { RgInput, UgInput, ProbeInput, SgInput, CbmInput, LspInput, SerenaInput, FffInput, RgMatch, } from "./code-intelligence.js";
+export { success, fail, getErrorMessage } from "./utils.js";

package/dist-cjs/executors/index.js

@@ -0,0 +1,143 @@
+"use strict";
+/**
+ * @aria/tools - Tool executors
+ *
+ * Executor functions that implement actual tool functionality.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PTYTimeoutError = exports.PTYSession = exports.executeBrowse = exports.executeWebFetch = exports.executeWebSearch = exports.getSelfContext = exports.getSessionTranscript = exports.getConversationContext = exports.executeReflect = exports.executeDiscover = exports.executeForget = exports.executeRecall = exports.executeRemember = exports.SHELL_BLOCKED_PATTERNS = exports.classifyCommand = exports.sanitizeEnv = exports.sanitizeGitEnv = exports.executeWriteStdin = exports.executeWaitProcess = exports.executeListProcesses = exports.executeKill = exports.executeSpawn = exports.executeExec = exports.executeBash = exports.executeApplyPatch = exports.MAX_CACHED_MUTATION_CONTENT_BYTES = exports.MAX_PENDING_MUTATION_BYTES_BEFORE_SYNC_FLUSH = exports.MAX_PENDING_MUTATIONS_BEFORE_SYNC_FLUSH = exports.BACKGROUND_FRG_MAX_FLUSH_DELAY_MS = exports.DEFAULT_BACKGROUND_FRG_FLUSH_DELAY_MS = exports.shouldForceSynchronousFrgFlush = exports.scheduleBackgroundFrgFlush = exports.getFrgFreshnessSnapshot = exports.getFrgFlushStatus = exports.getGitDirtyStatus = exports.reconcileGitDirtyMutations = exports.ensureFrgRepoStateLoaded = exports.maybeBuildFrgIndexForRepo = exports.flushPendingFrgMutations = exports.clearPendingFrgMutations = exports.getPendingFrgMutationBytes = exports.getPendingFrgMutations = exports.recordFrgMutation = exports.executeFrg = exports.executeGrep = exports.executeGlob = exports.executeLs = exports.executeEditFile = exports.executeWriteFile = exports.executeReadFile = void 0;
+exports.getErrorMessage = exports.fail = exports.success = exports.executeFff = exports.executeSerena = exports.executeLsp = exports.executeCbm = exports.executeSg = exports.executeProbe = exports.executeUg = exports.executeRg = exports.executeDeploy = exports.executeRestart = exports.executeSelfDiagnose = exports.executeSessionHistory = exports.dedupSearchResults = exports.SOURCE_PRIORITY = exports.fetchJson = exports.settleWithDeadline = exports.getOSContext = exports.searchWeb = exports.searchSkillRegistries = exports.searchLocalSkills = exports.searchMemoria = exports.executeUseSkill = exports.executeCreateSkill = exports.executeCreateTool = exports.executeLearnLegacy = exports.executeLearnSkill = exports.executeLearnTool = exports.executeSearchKnowledge = exports.resetAskUserCounter = exports.executeQuestList = exports.executeQuestUpdate = exports.executeAskUser = exports.SpawnedProcessRegistry = exports.executeRetireArion = exports.executeWakeArion = exports.executeRestArion = exports.executeHatchArion = exports.PTYSessionStore = exports.runInPTY = exports.createPTYSession = exports.PTYError = void 0;
+// Filesystem executors
+var filesystem_js_1 = require("./filesystem.js");
+Object.defineProperty(exports, "executeReadFile", { enumerable: true, get: function () { return filesystem_js_1.executeReadFile; } });
+Object.defineProperty(exports, "executeWriteFile", { enumerable: true, get: function () { return filesystem_js_1.executeWriteFile; } });
+Object.defineProperty(exports, "executeEditFile", { enumerable: true, get: function () { return filesystem_js_1.executeEditFile; } });
+Object.defineProperty(exports, "executeLs", { enumerable: true, get: function () { return filesystem_js_1.executeLs; } });
+Object.defineProperty(exports, "executeGlob", { enumerable: true, get: function () { return filesystem_js_1.executeGlob; } });
+Object.defineProperty(exports, "executeGrep", { enumerable: true, get: function () { return filesystem_js_1.executeGrep; } });
+// fastripgrep executors
+var frg_js_1 = require("./frg.js");
+Object.defineProperty(exports, "executeFrg", { enumerable: true, get: function () { return frg_js_1.executeFrg; } });
+var frg_freshness_js_1 = require("./frg-freshness.js");
+Object.defineProperty(exports, "recordFrgMutation", { enumerable: true, get: function () { return frg_freshness_js_1.recordFrgMutation; } });
+Object.defineProperty(exports, "getPendingFrgMutations", { enumerable: true, get: function () { return frg_freshness_js_1.getPendingFrgMutations; } });
+Object.defineProperty(exports, "getPendingFrgMutationBytes", { enumerable: true, get: function () { return frg_freshness_js_1.getPendingFrgMutationBytes; } });
+Object.defineProperty(exports, "clearPendingFrgMutations", { enumerable: true, get: function () { return frg_freshness_js_1.clearPendingFrgMutations; } });
+Object.defineProperty(exports, "flushPendingFrgMutations", { enumerable: true, get: function () { return frg_freshness_js_1.flushPendingFrgMutations; } });
+Object.defineProperty(exports, "maybeBuildFrgIndexForRepo", { enumerable: true, get: function () { return frg_freshness_js_1.maybeBuildFrgIndexForRepo; } });
+Object.defineProperty(exports, "ensureFrgRepoStateLoaded", { enumerable: true, get: function () { return frg_freshness_js_1.ensureFrgRepoStateLoaded; } });
+Object.defineProperty(exports, "reconcileGitDirtyMutations", { enumerable: true, get: function () { return frg_freshness_js_1.reconcileGitDirtyMutations; } });
+Object.defineProperty(exports, "getGitDirtyStatus", { enumerable: true, get: function () { return frg_freshness_js_1.getGitDirtyStatus; } });
+Object.defineProperty(exports, "getFrgFlushStatus", { enumerable: true, get: function () { return frg_freshness_js_1.getFrgFlushStatus; } });
+Object.defineProperty(exports, "getFrgFreshnessSnapshot", { enumerable: true, get: function () { return frg_freshness_js_1.getFrgFreshnessSnapshot; } });
+Object.defineProperty(exports, "scheduleBackgroundFrgFlush", { enumerable: true, get: function () { return frg_freshness_js_1.scheduleBackgroundFrgFlush; } });
+Object.defineProperty(exports, "shouldForceSynchronousFrgFlush", { enumerable: true, get: function () { return frg_freshness_js_1.shouldForceSynchronousFrgFlush; } });
+Object.defineProperty(exports, "DEFAULT_BACKGROUND_FRG_FLUSH_DELAY_MS", { enumerable: true, get: function () { return frg_freshness_js_1.DEFAULT_BACKGROUND_FRG_FLUSH_DELAY_MS; } });
+Object.defineProperty(exports, "BACKGROUND_FRG_MAX_FLUSH_DELAY_MS", { enumerable: true, get: function () { return frg_freshness_js_1.BACKGROUND_FRG_MAX_FLUSH_DELAY_MS; } });
+Object.defineProperty(exports, "MAX_PENDING_MUTATIONS_BEFORE_SYNC_FLUSH", { enumerable: true, get: function () { return frg_freshness_js_1.MAX_PENDING_MUTATIONS_BEFORE_SYNC_FLUSH; } });
+Object.defineProperty(exports, "MAX_PENDING_MUTATION_BYTES_BEFORE_SYNC_FLUSH", { enumerable: true, get: function () { return frg_freshness_js_1.MAX_PENDING_MUTATION_BYTES_BEFORE_SYNC_FLUSH; } });
+Object.defineProperty(exports, "MAX_CACHED_MUTATION_CONTENT_BYTES", { enumerable: true, get: function () { return frg_freshness_js_1.MAX_CACHED_MUTATION_CONTENT_BYTES; } });
+// Apply Patch executor
+var apply_patch_js_1 = require("./apply-patch.js");
+Object.defineProperty(exports, "executeApplyPatch", { enumerable: true, get: function () { return apply_patch_js_1.executeApplyPatch; } });
+// Shell executors
+var shell_js_1 = require("./shell.js");
+Object.defineProperty(exports, "executeBash", { enumerable: true, get: function () { return shell_js_1.executeBash; } });
+Object.defineProperty(exports, "executeExec", { enumerable: true, get: function () { return shell_js_1.executeExec; } });
+Object.defineProperty(exports, "executeSpawn", { enumerable: true, get: function () { return shell_js_1.executeSpawn; } });
+Object.defineProperty(exports, "executeKill", { enumerable: true, get: function () { return shell_js_1.executeKill; } });
+Object.defineProperty(exports, "executeListProcesses", { enumerable: true, get: function () { return shell_js_1.executeListProcesses; } });
+Object.defineProperty(exports, "executeWaitProcess", { enumerable: true, get: function () { return shell_js_1.executeWaitProcess; } });
+Object.defineProperty(exports, "executeWriteStdin", { enumerable: true, get: function () { return shell_js_1.executeWriteStdin; } });
+Object.defineProperty(exports, "sanitizeGitEnv", { enumerable: true, get: function () { return shell_js_1.sanitizeGitEnv; } });
+Object.defineProperty(exports, "sanitizeEnv", { enumerable: true, get: function () { return shell_js_1.sanitizeEnv; } });
+var shell_safety_js_1 = require("./shell-safety.js");
+Object.defineProperty(exports, "classifyCommand", { enumerable: true, get: function () { return shell_safety_js_1.classifyCommand; } });
+Object.defineProperty(exports, "SHELL_BLOCKED_PATTERNS", { enumerable: true, get: function () { return shell_safety_js_1.BLOCKED_PATTERNS; } });
+// Memory executors
+var memory_js_1 = require("./memory.js");
+Object.defineProperty(exports, "executeRemember", { enumerable: true, get: function () { return memory_js_1.executeRemember; } });
+Object.defineProperty(exports, "executeRecall", { enumerable: true, get: function () { return memory_js_1.executeRecall; } });
+Object.defineProperty(exports, "executeForget", { enumerable: true, get: function () { return memory_js_1.executeForget; } });
+Object.defineProperty(exports, "executeDiscover", { enumerable: true, get: function () { return memory_js_1.executeDiscover; } });
+Object.defineProperty(exports, "executeReflect", { enumerable: true, get: function () { return memory_js_1.executeReflect; } });
+Object.defineProperty(exports, "getConversationContext", { enumerable: true, get: function () { return memory_js_1.getConversationContext; } });
+Object.defineProperty(exports, "getSessionTranscript", { enumerable: true, get: function () { return memory_js_1.getSessionTranscript; } });
+Object.defineProperty(exports, "getSelfContext", { enumerable: true, get: function () { return memory_js_1.getSelfContext; } });
+// Web executors
+var web_js_1 = require("./web.js");
+Object.defineProperty(exports, "executeWebSearch", { enumerable: true, get: function () { return web_js_1.executeWebSearch; } });
+Object.defineProperty(exports, "executeWebFetch", { enumerable: true, get: function () { return web_js_1.executeWebFetch; } });
+Object.defineProperty(exports, "executeBrowse", { enumerable: true, get: function () { return web_js_1.executeBrowse; } });
+// PTY executors
+var pty_js_1 = require("./pty.js");
+Object.defineProperty(exports, "PTYSession", { enumerable: true, get: function () { return pty_js_1.PTYSession; } });
+Object.defineProperty(exports, "PTYTimeoutError", { enumerable: true, get: function () { return pty_js_1.PTYTimeoutError; } });
+Object.defineProperty(exports, "PTYError", { enumerable: true, get: function () { return pty_js_1.PTYError; } });
+Object.defineProperty(exports, "createPTYSession", { enumerable: true, get: function () { return pty_js_1.createPTYSession; } });
+Object.defineProperty(exports, "runInPTY", { enumerable: true, get: function () { return pty_js_1.runInPTY; } });
+// PTY session store
+var pty_session_store_js_1 = require("./pty-session-store.js");
+Object.defineProperty(exports, "PTYSessionStore", { enumerable: true, get: function () { return pty_session_store_js_1.PTYSessionStore; } });
+// Arion executors
+var arion_js_1 = require("./arion.js");
+Object.defineProperty(exports, "executeHatchArion", { enumerable: true, get: function () { return arion_js_1.executeHatchArion; } });
+Object.defineProperty(exports, "executeRestArion", { enumerable: true, get: function () { return arion_js_1.executeRestArion; } });
+Object.defineProperty(exports, "executeWakeArion", { enumerable: true, get: function () { return arion_js_1.executeWakeArion; } });
+Object.defineProperty(exports, "executeRetireArion", { enumerable: true, get: function () { return arion_js_1.executeRetireArion; } });
+// Process registry
+var process_registry_js_1 = require("./process-registry.js");
+Object.defineProperty(exports, "SpawnedProcessRegistry", { enumerable: true, get: function () { return process_registry_js_1.SpawnedProcessRegistry; } });
+// Meta executors
+var meta_js_1 = require("./meta.js");
+Object.defineProperty(exports, "executeAskUser", { enumerable: true, get: function () { return meta_js_1.executeAskUser; } });
+Object.defineProperty(exports, "executeQuestUpdate", { enumerable: true, get: function () { return meta_js_1.executeQuestUpdate; } });
+Object.defineProperty(exports, "executeQuestList", { enumerable: true, get: function () { return meta_js_1.executeQuestList; } });
+Object.defineProperty(exports, "resetAskUserCounter", { enumerable: true, get: function () { return meta_js_1.resetAskUserCounter; } });
+// Learning/meta capability executors
+var learning_meta_js_1 = require("./learning-meta.js");
+Object.defineProperty(exports, "executeSearchKnowledge", { enumerable: true, get: function () { return learning_meta_js_1.executeSearchKnowledge; } });
+Object.defineProperty(exports, "executeLearnTool", { enumerable: true, get: function () { return learning_meta_js_1.executeLearnTool; } });
+Object.defineProperty(exports, "executeLearnSkill", { enumerable: true, get: function () { return learning_meta_js_1.executeLearnSkill; } });
+Object.defineProperty(exports, "executeLearnLegacy", { enumerable: true, get: function () { return learning_meta_js_1.executeLearnLegacy; } });
+Object.defineProperty(exports, "executeCreateTool", { enumerable: true, get: function () { return learning_meta_js_1.executeCreateTool; } });
+Object.defineProperty(exports, "executeCreateSkill", { enumerable: true, get: function () { return learning_meta_js_1.executeCreateSkill; } });
+Object.defineProperty(exports, "executeUseSkill", { enumerable: true, get: function () { return learning_meta_js_1.executeUseSkill; } });
+// Search source helpers — used by runner wrapper (search-wrapper.ts)
+Object.defineProperty(exports, "searchMemoria", { enumerable: true, get: function () { return learning_meta_js_1.searchMemoria; } });
+Object.defineProperty(exports, "searchLocalSkills", { enumerable: true, get: function () { return learning_meta_js_1.searchLocalSkills; } });
+Object.defineProperty(exports, "searchSkillRegistries", { enumerable: true, get: function () { return learning_meta_js_1.searchSkillRegistries; } });
+Object.defineProperty(exports, "searchWeb", { enumerable: true, get: function () { return learning_meta_js_1.searchWeb; } });
+Object.defineProperty(exports, "getOSContext", { enumerable: true, get: function () { return learning_meta_js_1.getOSContext; } });
+Object.defineProperty(exports, "settleWithDeadline", { enumerable: true, get: function () { return learning_meta_js_1.settleWithDeadline; } });
+Object.defineProperty(exports, "fetchJson", { enumerable: true, get: function () { return learning_meta_js_1.fetchJson; } });
+var search_types_js_1 = require("./search-types.js");
+Object.defineProperty(exports, "SOURCE_PRIORITY", { enumerable: true, get: function () { return search_types_js_1.SOURCE_PRIORITY; } });
+Object.defineProperty(exports, "dedupSearchResults", { enumerable: true, get: function () { return search_types_js_1.dedupSearchResults; } });
+// Session History executors
+var session_history_js_1 = require("./session-history.js");
+Object.defineProperty(exports, "executeSessionHistory", { enumerable: true, get: function () { return session_history_js_1.executeSessionHistory; } });
+// Self-diagnose executor
+var self_diagnose_js_1 = require("./self-diagnose.js");
+Object.defineProperty(exports, "executeSelfDiagnose", { enumerable: true, get: function () { return self_diagnose_js_1.executeSelfDiagnose; } });
+// Restart executor
+var restart_js_1 = require("./restart.js");
+Object.defineProperty(exports, "executeRestart", { enumerable: true, get: function () { return restart_js_1.executeRestart; } });
+// Deploy executor
+var deploy_js_1 = require("./deploy.js");
+Object.defineProperty(exports, "executeDeploy", { enumerable: true, get: function () { return deploy_js_1.executeDeploy; } });
+// Code Intelligence executors
+var code_intelligence_js_1 = require("./code-intelligence.js");
+Object.defineProperty(exports, "executeRg", { enumerable: true, get: function () { return code_intelligence_js_1.executeRg; } });
+Object.defineProperty(exports, "executeUg", { enumerable: true, get: function () { return code_intelligence_js_1.executeUg; } });
+Object.defineProperty(exports, "executeProbe", { enumerable: true, get: function () { return code_intelligence_js_1.executeProbe; } });
+Object.defineProperty(exports, "executeSg", { enumerable: true, get: function () { return code_intelligence_js_1.executeSg; } });
+Object.defineProperty(exports, "executeCbm", { enumerable: true, get: function () { return code_intelligence_js_1.executeCbm; } });
+Object.defineProperty(exports, "executeLsp", { enumerable: true, get: function () { return code_intelligence_js_1.executeLsp; } });
+Object.defineProperty(exports, "executeSerena", { enumerable: true, get: function () { return code_intelligence_js_1.executeSerena; } });
+Object.defineProperty(exports, "executeFff", { enumerable: true, get: function () { return code_intelligence_js_1.executeFff; } });
+// Shared executor utilities
+var utils_js_1 = require("./utils.js");
+Object.defineProperty(exports, "success", { enumerable: true, get: function () { return utils_js_1.success; } });
+Object.defineProperty(exports, "fail", { enumerable: true, get: function () { return utils_js_1.fail; } });
+Object.defineProperty(exports, "getErrorMessage", { enumerable: true, get: function () { return utils_js_1.getErrorMessage; } });

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

@@ -0,0 +1,87 @@
+/**
+ * @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>;