@aria-cli/tools 1.0.10 → 1.0.12

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

@@ -0,0 +1,50 @@
+/**
+ * @aria/tools - Arion tool executors
+ *
+ * Implementation of arion operations for ARIA tool system.
+ * These executors create and manage arion personas.
+ */
+import type { ToolContext, ToolResult } from "../types.js";
+export interface HatchArionInput {
+    /** Name for the new arion */
+    name: string;
+    /** Visual emoji identifier */
+    emoji?: string;
+    /** Core personality traits */
+    traits: string[];
+    /** Communication style */
+    style: "formal" | "casual" | "technical" | "friendly";
+    /** Core beliefs to seed memory with */
+    beliefs?: string[];
+    /** Brief backstory */
+    background?: string;
+    /** Unique behavioral quirks */
+    quirks?: string[];
+    /** Areas of strength */
+    strengths?: string[];
+}
+export interface HatchArionOutput {
+    /** ID of the created arion */
+    arionId: string;
+    /** Name of the arion */
+    name: string;
+    /** Emoji of the arion */
+    emoji: string;
+}
+/**
+ * Creates a new arion persona with the specified configuration.
+ * Requires user confirmation and arion context (manager) to execute.
+ */
+export declare function executeHatchArion(input: HatchArionInput, ctx: ToolContext): Promise<ToolResult>;
+export interface RestArionInput {
+    name: string;
+}
+export declare function executeRestArion(input: RestArionInput, ctx: ToolContext): Promise<ToolResult>;
+export interface WakeArionInput {
+    name: string;
+}
+export declare function executeWakeArion(input: WakeArionInput, ctx: ToolContext): Promise<ToolResult>;
+export interface RetireArionInput {
+    name: string;
+}
+export declare function executeRetireArion(input: RetireArionInput, ctx: ToolContext): Promise<ToolResult>;

package/dist-cjs/executors/arion.js

@@ -0,0 +1,125 @@
+"use strict";
+/**
+ * @aria/tools - Arion tool executors
+ *
+ * Implementation of arion operations for ARIA tool system.
+ * These executors create and manage arion personas.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.executeHatchArion = executeHatchArion;
+exports.executeRestArion = executeRestArion;
+exports.executeWakeArion = executeWakeArion;
+exports.executeRetireArion = executeRetireArion;
+const utils_js_1 = require("./utils.js");
+/**
+ * Creates a new arion persona with the specified configuration.
+ * Requires user confirmation and arion context (manager) to execute.
+ */
+async function executeHatchArion(input, ctx) {
+    // Validate required fields
+    if (!input.name) {
+        return (0, utils_js_1.fail)("name is required");
+    }
+    if (!input.traits || input.traits.length === 0) {
+        return (0, utils_js_1.fail)("traits array is required and cannot be empty");
+    }
+    if (!input.style) {
+        return (0, utils_js_1.fail)("style is required");
+    }
+    // Check if manager is available
+    if (!ctx.manager) {
+        return (0, utils_js_1.fail)("ArionManager is not available in context");
+    }
+    if (!ctx.arion) {
+        return (0, utils_js_1.fail)("Current arion context is required to hatch new arions");
+    }
+    // Build confirmation message
+    const traitList = input.traits.join(", ");
+    const confirmMessage = input.emoji
+        ? `Create arion "${input.emoji} ${input.name}" with traits: ${traitList}?`
+        : `Create arion "${input.name}" with traits: ${traitList}?`;
+    // Request user confirmation
+    const confirmed = await ctx.confirm(confirmMessage);
+    if (!confirmed) {
+        return (0, utils_js_1.fail)("User cancelled arion creation");
+    }
+    try {
+        // Build the hatch configuration
+        // We use a generic config object since ArionHatchConfig is in @aria/aria
+        const hatchConfig = {
+            name: input.name,
+            emoji: input.emoji,
+            personality: {
+                traits: input.traits,
+                style: input.style,
+                quirks: input.quirks,
+            },
+            profile: {
+                background: input.background,
+            },
+            strengths: input.strengths,
+            createdBy: ctx.arion.name,
+        };
+        // Create the arion
+        const arion = await ctx.manager.hatch(hatchConfig);
+        // Seed beliefs into the new arion's memory
+        if (input.beliefs?.length && ctx.manager.getMemoria) {
+            const memoria = await ctx.manager.getMemoria(arion);
+            if (memoria) {
+                for (const belief of input.beliefs) {
+                    await memoria.remember(belief, { network: "beliefs" });
+                }
+            }
+        }
+        return (0, utils_js_1.success)(`${arion.emoji} ${arion.name} has hatched!`, {
+            arionId: arion.id,
+            name: arion.name,
+            emoji: arion.emoji,
+        });
+    }
+    catch (error) {
+        return (0, utils_js_1.fail)(`Failed to create arion: ${error instanceof Error ? error.message : String(error)}`);
+    }
+}
+async function executeRestArion(input, ctx) {
+    if (!input.name)
+        return (0, utils_js_1.fail)("name is required");
+    if (!ctx.manager)
+        return (0, utils_js_1.fail)("ArionManager is not available in context");
+    try {
+        await ctx.manager.rest(input.name);
+        return (0, utils_js_1.success)(`${input.name} is now resting`);
+    }
+    catch (error) {
+        return (0, utils_js_1.fail)(`Failed to rest arion: ${error instanceof Error ? error.message : String(error)}`);
+    }
+}
+async function executeWakeArion(input, ctx) {
+    if (!input.name)
+        return (0, utils_js_1.fail)("name is required");
+    if (!ctx.manager)
+        return (0, utils_js_1.fail)("ArionManager is not available in context");
+    try {
+        await ctx.manager.wake(input.name);
+        return (0, utils_js_1.success)(`${input.name} is now awake`);
+    }
+    catch (error) {
+        return (0, utils_js_1.fail)(`Failed to wake arion: ${error instanceof Error ? error.message : String(error)}`);
+    }
+}
+async function executeRetireArion(input, ctx) {
+    if (!input.name)
+        return (0, utils_js_1.fail)("name is required");
+    if (!ctx.manager)
+        return (0, utils_js_1.fail)("ArionManager is not available in context");
+    const confirmed = await ctx.confirm(`Permanently retire "${input.name}"? This cannot be undone.`);
+    if (!confirmed)
+        return (0, utils_js_1.fail)("User cancelled arion retirement");
+    try {
+        await ctx.manager.retire(input.name, { confirm: true });
+        return (0, utils_js_1.success)(`${input.name} has been retired`);
+    }
+    catch (error) {
+        return (0, utils_js_1.fail)(`Failed to retire arion: ${error instanceof Error ? error.message : String(error)}`);
+    }
+}

package/dist-cjs/executors/code-intelligence.d.ts

@@ -0,0 +1,138 @@
+/**
+ * @aria/tools - Code intelligence executors
+ *
+ * 7 native tools wrapping external CLI binaries:
+ * rg (ripgrep), ug (ugrep), probe, sg (ast-grep),
+ * cbm (codebase-memory-mcp), serena, fff
+ */
+import type { ToolContext, ToolResult } from "../types.js";
+export interface RgInput {
+    pattern: string;
+    path?: string;
+    ignore_case?: boolean;
+    smart_case?: boolean;
+    fixed_strings?: boolean;
+    word_regexp?: boolean;
+    file_type?: string;
+    glob?: string;
+    context?: number;
+    max_count?: number;
+    invert?: boolean;
+    files_only?: boolean;
+    count?: boolean;
+    extra_args?: string[];
+}
+export interface UgInput {
+    pattern: string;
+    path?: string;
+    ignore_case?: boolean;
+    smart_case?: boolean;
+    fixed_strings?: boolean;
+    word_regexp?: boolean;
+    file_type?: string;
+    glob?: string;
+    context?: number;
+    max_count?: number;
+    fuzzy?: boolean | number;
+    bool?: boolean;
+    neg_pattern?: string;
+    files_only?: boolean;
+    count?: boolean;
+    decompress?: boolean;
+    extra_args?: string[];
+}
+export interface ProbeInput {
+    command?: "search" | "extract" | "symbols" | "query";
+    query?: string;
+    path?: string;
+    exact?: boolean;
+    max_tokens?: number;
+    max_results?: number;
+    session?: string;
+    language?: string;
+    reranker?: string;
+    allow_tests?: boolean;
+    files?: string[];
+    extra_args?: string[];
+}
+export interface SgInput {
+    command?: "run" | "scan";
+    pattern?: string;
+    language?: string;
+    rewrite?: string;
+    strictness?: "cst" | "smart" | "ast" | "relaxed" | "signature";
+    globs?: string;
+    rule?: string;
+    inline_rules?: string;
+    path?: string;
+    update_all?: boolean;
+    context?: number;
+    extra_args?: string[];
+}
+export interface CbmInput {
+    action: "index" | "search" | "trace" | "impact" | "context" | "snippet" | "code_search" | "architecture" | "schema" | "cypher" | "list_projects" | "delete_project" | "status";
+    path?: string;
+    mode?: "full" | "fast";
+    name?: string;
+    label?: string;
+    file?: string;
+    direction?: "inbound" | "outbound" | "both";
+    depth?: number;
+    edge_types?: string[];
+    scope?: string;
+    base_branch?: string;
+    qualified_name?: string;
+    include_neighbors?: boolean;
+    code_pattern?: string;
+    regex?: boolean;
+    code_mode?: "compact" | "full" | "files";
+    query?: string;
+    max_rows?: number;
+    project?: string;
+    limit?: number;
+    context?: number;
+}
+export interface LspInput {
+    action: "definition" | "references" | "hover" | "symbols" | "rename";
+    file: string;
+    line?: number;
+    character?: number;
+    new_name?: string;
+}
+export interface SerenaInput {
+    action: "find_symbol" | "find_references" | "overview" | "replace_body" | "insert_after" | "insert_before" | "rename" | "search";
+    name_path?: string;
+    relative_path?: string;
+    include_body?: boolean;
+    include_info?: boolean;
+    depth?: number;
+    body?: string;
+    new_name?: string;
+    pattern?: string;
+    context_before?: number;
+    context_after?: number;
+    paths_include?: string;
+    paths_exclude?: string;
+    extra_args?: Record<string, unknown>;
+}
+export interface FffInput {
+    action: "grep" | "find_files" | "multi_grep";
+    query?: string;
+    patterns?: string[];
+    constraints?: string;
+    path?: string;
+}
+export interface RgMatch {
+    file: string;
+    line: number;
+    text: string;
+    submatches: string[];
+}
+export declare function executeRg(input: RgInput, ctx: ToolContext): Promise<ToolResult>;
+export declare function executeUg(input: UgInput, ctx: ToolContext): Promise<ToolResult>;
+export declare function executeProbe(input: ProbeInput, ctx: ToolContext): Promise<ToolResult>;
+export declare function executeSg(input: SgInput, ctx: ToolContext): Promise<ToolResult>;
+export declare function executeCbm(input: CbmInput, ctx: ToolContext): Promise<ToolResult>;
+export declare function executeLsp(input: LspInput, ctx: ToolContext): Promise<ToolResult>;
+export declare function executeSerena(input: SerenaInput, ctx: ToolContext): Promise<ToolResult>;
+export declare function executeFff(input: FffInput, ctx: ToolContext): Promise<ToolResult>;