@aria-cli/tools 1.0.18 → 1.0.31

package/dist/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/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/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/executors/index.d.ts

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

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