@aria-cli/tools 1.0.10 → 1.0.11

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>;