@aria-cli/tools 1.0.10 → 1.0.11

package/dist-cjs/definitions/meta.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Meta tool definitions
+ *
+ * Tools:
+ * - ask_user, quest_update, quest_list
+ * - search, learn_tool, learn_skill
+ * - create_tool, create_skill, use_skill
+ */
+import type { Tool } from "../types.js";
+/** Meta tool definitions */
+export declare const META_TOOL_DEFINITIONS: Tool[];

package/dist-cjs/definitions/meta.js

@@ -0,0 +1,353 @@
+"use strict";
+/**
+ * Meta tool definitions
+ *
+ * Tools:
+ * - ask_user, quest_update, quest_list
+ * - search, learn_tool, learn_skill
+ * - create_tool, create_skill, use_skill
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.META_TOOL_DEFINITIONS = void 0;
+const index_js_1 = require("../executors/index.js");
+const ask_user = {
+    name: "ask_user",
+    description: "Ask the user clarifying questions. Supports optional multiple-choice answers. Use when you need user input to proceed.",
+    category: "meta",
+    parameters: {
+        type: "object",
+        properties: {
+            questions: {
+                type: "array",
+                description: "List of questions to ask the user",
+                items: {
+                    type: "object",
+                    properties: {
+                        question: {
+                            type: "string",
+                            description: "The question to ask",
+                        },
+                        options: {
+                            type: "array",
+                            items: { type: "string" },
+                            description: "Optional multiple-choice answers",
+                        },
+                    },
+                    required: ["question"],
+                },
+            },
+        },
+        required: ["questions"],
+    },
+    riskLevel: "moderate",
+    // Human interaction is a resumable barrier, not a parallel read-only batch item.
+    isReadOnly: false,
+    loadingTier: "always",
+    execute: index_js_1.executeAskUser,
+};
+const quest_update = {
+    name: "quest_update",
+    description: "Create, update, or complete quests (task tracking). Quests persist in a structured database across sessions.",
+    category: "meta",
+    parameters: {
+        type: "object",
+        properties: {
+            quests: {
+                type: "array",
+                description: "List of quests to create or update",
+                items: {
+                    type: "object",
+                    properties: {
+                        id: {
+                            type: "string",
+                            description: "Quest ID (omit to create a new quest)",
+                        },
+                        title: {
+                            type: "string",
+                            description: "Quest title",
+                        },
+                        status: {
+                            type: "string",
+                            enum: ["open", "active", "blocked", "done"],
+                            description: "Quest status: open (ready), active (in progress), blocked, done",
+                        },
+                        priority: {
+                            type: "number",
+                            description: "Priority 0-4 (0 = highest, default 2)",
+                            minimum: 0,
+                            maximum: 4,
+                        },
+                        blocked_by: {
+                            type: "string",
+                            description: "ID of quest blocking this one",
+                        },
+                        notes: {
+                            type: "string",
+                            description: "Progress notes or context",
+                        },
+                    },
+                    required: [],
+                },
+            },
+        },
+        required: ["quests"],
+    },
+    riskLevel: "moderate",
+    isReadOnly: false,
+    loadingTier: "always",
+    execute: index_js_1.executeQuestUpdate,
+};
+const quest_list = {
+    name: "quest_list",
+    description: "List current quests with their status, priority, and dependencies.",
+    category: "meta",
+    parameters: {
+        type: "object",
+        properties: {
+            status: {
+                type: "string",
+                enum: ["all", "open", "active", "blocked", "done"],
+                description: "Filter by status (default: all)",
+                default: "all",
+            },
+        },
+        required: [],
+    },
+    riskLevel: "safe",
+    isReadOnly: true,
+    loadingTier: "always",
+    execute: index_js_1.executeQuestList,
+};
+const search = {
+    name: "search",
+    description: "Search for tools, skills, and capabilities across Memoria, local skill files, skill registries, and optional web/package sources.",
+    category: "meta",
+    parameters: {
+        type: "object",
+        properties: {
+            query: {
+                type: "string",
+                description: "What to find — tool name, skill name, or capability description",
+            },
+            sources: {
+                type: "array",
+                items: {
+                    type: "string",
+                    enum: ["memoria", "local", "registry", "web"],
+                },
+                default: ["memoria", "local", "registry"],
+                description: "Where to search. memoria=learned tools/skills, local=SKILL.md files, registry=skills.sh+clawhub, web=npm/brew+general",
+            },
+            limit: { type: "number", minimum: 1, maximum: 50, default: 10 },
+        },
+        required: ["query"],
+    },
+    riskLevel: "safe",
+    isReadOnly: true,
+    loadingTier: "always",
+    execute: index_js_1.executeSearchKnowledge,
+};
+const learn_tool = {
+    name: "learn_tool",
+    description: "Learn a CLI tool from `<command> --help` and persist it as callable tool knowledge. (Deprecated — use learn instead)",
+    category: "meta",
+    parameters: {
+        type: "object",
+        properties: {
+            command: { type: "string", description: "CLI command name (supports subcommands)" },
+            name: { type: "string" },
+            description: { type: "string" },
+            category: {
+                type: "string",
+                enum: ["filesystem", "code", "shell", "web", "data", "memory", "meta", "arion"],
+            },
+        },
+        required: ["command"],
+    },
+    riskLevel: "moderate",
+    isReadOnly: false,
+    loadingTier: "always",
+    execute: (input, ctx) => (0, index_js_1.executeLearnLegacy)({ source: { type: "cli", command: String(input.command ?? "") } }, ctx),
+};
+const learn_skill = {
+    name: "learn_skill",
+    description: "Learn a skill from a SKILL.md file or inline content and persist it in Memoria. (Deprecated — use learn instead)",
+    category: "meta",
+    parameters: {
+        type: "object",
+        properties: {
+            path: { type: "string", description: "Path to SKILL.md (optional if using inline content)" },
+            name: { type: "string" },
+            description: { type: "string" },
+            content: { type: "string" },
+            tags: { type: "array", items: { type: "string" } },
+            toolIds: { type: "array", items: { type: "string" } },
+        },
+        required: [],
+    },
+    riskLevel: "moderate",
+    isReadOnly: false,
+    loadingTier: "always",
+    execute: (input, ctx) => (0, index_js_1.executeLearnLegacy)({ source: { type: "file", path: String(input.path ?? "") } }, ctx),
+};
+const learn = {
+    name: "learn",
+    description: "Backward-compatible learning tool. Delegates to learn_tool (CLI) or learn_skill (file).",
+    category: "meta",
+    parameters: {
+        type: "object",
+        properties: {
+            source: {
+                type: "object",
+                properties: {
+                    type: { type: "string", enum: ["cli", "file"] },
+                    command: { type: "string" },
+                    path: { type: "string" },
+                },
+                required: ["type"],
+            },
+        },
+        required: ["source"],
+    },
+    riskLevel: "moderate",
+    isReadOnly: false,
+    loadingTier: "always",
+    execute: index_js_1.executeLearnLegacy,
+};
+const create_tool = {
+    name: "create_tool",
+    description: "Create a reusable script-backed tool and save it to Memoria for future discovery/use.",
+    category: "meta",
+    parameters: {
+        type: "object",
+        properties: {
+            name: { type: "string" },
+            description: { type: "string" },
+            command: {
+                type: "string",
+                description: "Shell command to wrap (optional if script provided)",
+            },
+            script: {
+                type: "string",
+                description: "Script body to write (optional if command provided)",
+            },
+            argsSchema: { type: "object", additionalProperties: true },
+            tags: { type: "array", items: { type: "string" } },
+        },
+        required: ["name", "description"],
+    },
+    riskLevel: "dangerous",
+    isReadOnly: false,
+    loadingTier: "always",
+    execute: index_js_1.executeCreateTool,
+};
+const create_skill = {
+    name: "create_skill",
+    description: "Create a reusable skill/procedure and optionally link it to the current arion profile.",
+    category: "meta",
+    parameters: {
+        type: "object",
+        properties: {
+            name: { type: "string" },
+            description: { type: "string" },
+            content: { type: "string" },
+            level: { type: "string", enum: ["beginner", "intermediate", "advanced", "expert"] },
+            tags: { type: "array", items: { type: "string" } },
+            toolIds: { type: "array", items: { type: "string" } },
+        },
+        required: ["name", "description", "content"],
+    },
+    riskLevel: "moderate",
+    isReadOnly: false,
+    loadingTier: "always",
+    execute: index_js_1.executeCreateSkill,
+};
+const use_skill = {
+    name: "use_skill",
+    description: "Retrieve a learned skill by name/id and record its execution metrics.",
+    category: "meta",
+    parameters: {
+        type: "object",
+        properties: {
+            name: { type: "string" },
+            skillId: { type: "string" },
+            success: { type: "boolean", default: true },
+            durationMs: { type: "number" },
+            notes: { type: "string" },
+        },
+        required: [],
+    },
+    riskLevel: "safe",
+    isReadOnly: false,
+    loadingTier: "always",
+    execute: index_js_1.executeUseSkill,
+};
+const restart = {
+    name: "restart",
+    description: "Restart ARIA through the RelaunchSupervisor. Use when you need to pick up code changes after a build, recover from a corrupted state, or when explicitly asked to restart. Fails closed when no supervisor is attached.",
+    category: "meta",
+    parameters: {
+        type: "object",
+        properties: {
+            reason: {
+                type: "string",
+                description: "Why the restart is needed (logged for diagnostics)",
+            },
+        },
+    },
+    riskLevel: "dangerous",
+    requiresConfirmation: true,
+    loadingTier: "always",
+    execute: index_js_1.executeRestart,
+};
+const self_diagnose = {
+    name: "self_diagnose",
+    description: "Gather comprehensive diagnostic context for debugging ARIA's own errors, crashes, and runtime issues. Returns structured data from configs, error logs, crash dumps, databases, active quests, sessions, network, and model state — all in one call. Use this as the first step when investigating any ARIA bug or unexpected behavior.",
+    category: "meta",
+    parameters: {
+        type: "object",
+        properties: {
+            focus: {
+                type: "string",
+                description: "Optional keyword to filter errors/crashes (e.g. 'quest_update', 'OOM', 'crash')",
+            },
+            sections: {
+                type: "array",
+                items: {
+                    type: "string",
+                    enum: ["runtime", "errors", "crashes", "databases", "daemon", "network"],
+                },
+                description: "Optional subset of sections to return (default: all 6)",
+            },
+            since: {
+                type: "string",
+                description: "ISO timestamp cutoff — only show events after this (default: last 1h)",
+            },
+            limit: {
+                type: "number",
+                description: "Max entries per section (default: 10)",
+                default: 10,
+            },
+        },
+    },
+    riskLevel: "safe",
+    isReadOnly: true,
+    loadingTier: "always",
+    execute: index_js_1.executeSelfDiagnose,
+};
+/** Meta tool definitions */
+exports.META_TOOL_DEFINITIONS = [
+    ask_user,
+    quest_update,
+    quest_list,
+    search,
+    learn,
+    learn_tool,
+    learn_skill,
+    create_tool,
+    create_skill,
+    use_skill,
+    restart,
+    self_diagnose,
+];
+//# sourceMappingURL=meta.js.map

package/dist-cjs/definitions/meta.js.map

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

package/dist-cjs/definitions/network.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Network management tool definitions.
+ *
+ * Tools: manage_network, list_clients (2 tools)
+ *
+ * ARIA manages its own secure WireGuard network. The LLM uses this tool
+ * to invite peers, revoke access, list connections, and check status.
+ * No user configuration needed — the network auto-creates on first run.
+ */
+/** Network tool definitions (2) */
+export declare const NETWORK_TOOL_DEFINITIONS: import("../types.js").Tool[];

package/dist-cjs/definitions/network.js

@@ -0,0 +1,163 @@
+"use strict";
+/**
+ * Network management tool definitions.
+ *
+ * Tools: manage_network, list_clients (2 tools)
+ *
+ * ARIA manages its own secure WireGuard network. The LLM uses this tool
+ * to invite peers, revoke access, list connections, and check status.
+ * No user configuration needed — the network auto-creates on first run.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NETWORK_TOOL_DEFINITIONS = void 0;
+const zod_1 = require("zod");
+const tool_factory_js_1 = require("../tool-factory.js");
+const index_js_1 = require("../network-runtime/index.js");
+/**
+ * Network management — ARIA manages its own secure mesh network.
+ *
+ * Actions:
+ *   invite: Generate an invite token for a new peer
+ *   revoke: Remove a peer from the network
+ *   list_peers: List all connected Arions
+ *   status: Network health/connectivity status
+ */
+const manage_network = (0, tool_factory_js_1.tool)({
+    name: "manage_network",
+    description: "Manage ARIA's secure WireGuard mesh network. Invite peers to the network, " +
+        "revoke access, list connected Arions, or check network status. " +
+        "The network auto-creates on first run — no user configuration needed.",
+    parameters: zod_1.z.object({
+        action: zod_1.z
+            .enum(["invite", "revoke", "list_peers", "status"])
+            .describe("Network management action"),
+        displayName: zod_1.z.string().optional().describe("Optional local label for the invite"),
+        nodeId: index_js_1.NodeIdSchema.optional().describe("Durable remote node id (required for revoke)"),
+        duration: zod_1.z.number().optional().describe("Invite token validity in ms (default: no expiry)"),
+    }),
+    category: "arion",
+    riskLevel: "moderate",
+    isReadOnly: false,
+    execute: async (input, context) => {
+        // Network management requires the Memoria DB for peer registry
+        // The actual implementation lives in @aria-cli/wireguard — we only call it here
+        // through the runtime-owned control surface when it is wired in.
+        const networkControl = context.networkControl;
+        if (!networkControl) {
+            return {
+                success: false,
+                message: "Network manager not available. Secure networking requires the @aria-cli/wireguard package.",
+            };
+        }
+        switch (input.action) {
+            case "invite": {
+                try {
+                    const result = networkControl.invite(input.displayName, input.duration);
+                    const inviteLabel = input.displayName?.trim();
+                    return {
+                        success: true,
+                        message: `${inviteLabel ? `Invite token for "${inviteLabel}":\n\n` : "Invite token:\n\n"}${result.token}\n\n` +
+                            `Token security model: bearer credential in plaintext payload form. ` +
+                            `Share only via secure channels. They can join with: aria pairing join <token>`,
+                        data: { token: result.token, ...(inviteLabel ? { displayName: inviteLabel } : {}) },
+                    };
+                }
+                catch (e) {
+                    return { success: false, message: `invite failed: ${e.message}` };
+                }
+            }
+            case "revoke": {
+                if (!input.nodeId) {
+                    return { success: false, message: "nodeId is required for revoke action" };
+                }
+                const revoked = networkControl.revokePeer(index_js_1.NodeIdSchema.parse(input.nodeId));
+                if (!revoked) {
+                    return { success: false, message: `node "${input.nodeId}" not found` };
+                }
+                return {
+                    success: true,
+                    message: `Revoked access for "${input.nodeId}". They will be disconnected.`,
+                    data: { nodeId: input.nodeId, revoked: true },
+                };
+            }
+            case "list_peers": {
+                const peers = networkControl.listPeers();
+                if (peers.length === 0) {
+                    return {
+                        success: true,
+                        message: "No peers connected. Use manage_network(invite) to add peers.",
+                        data: { peers: [] },
+                    };
+                }
+                const networkSummary = peers
+                    .map((p) => `${p.displayNameSnapshot ?? p.nodeId} (membership=${p.membershipStatus ?? p.status}, route=${p.routeOwnership ?? "current"}, session=${p.sessionState ?? "none"}, delivery=${p.deliveryReadiness ?? "cannot_address"}) — ${p.endpointHost ?? "unknown"}:${p.endpointPort ?? "?"}`)
+                    .join("\n");
+                return {
+                    success: true,
+                    message: `${peers.length} peer(s):\n${networkSummary}`,
+                    data: { peers },
+                };
+            }
+            case "status": {
+                const status = networkControl.status();
+                // Include signing public key for message signature verification
+                const signingPublicKey = status.signingPublicKey ?? null;
+                return {
+                    success: true,
+                    message: status.configured
+                        ? `Network active. Node: ${status.nodeId?.slice(0, 12) ?? "unknown"}... ` +
+                            `Transport: ${status.transportPublicKey?.slice(0, 12) ?? "unknown"}... ` +
+                            `Port: ${status.listenPort}. ` +
+                            `External: ${status.externalEndpoint ? `${status.externalEndpoint.address}:${status.externalEndpoint.port}` : "unknown"}. ` +
+                            `Peers: ${status.activePeers} trusted / ${status.totalPeers} total. ` +
+                            `Sessions: ${status.connectedPeers ?? 0} connected, ${status.handshakingPeers ?? 0} handshaking. ` +
+                            `Delivery: ${status.queueOnlyPeers ?? 0} queue-only, ${status.supersededPeers ?? 0} superseded.` +
+                            (signingPublicKey ? ` Signing key: ${signingPublicKey.slice(0, 12)}...` : "")
+                        : "Network not configured. It will be created automatically on next startup.",
+                    data: { ...status, signingPublicKey },
+                };
+            }
+            default:
+                return { success: false, message: `Unknown action: ${input.action}` };
+        }
+    },
+});
+/** Network tool definitions (1) */
+const list_clients = (0, tool_factory_js_1.tool)({
+    name: "list_clients",
+    description: "List same-home attached clients that share this runtime. Use this before sending a direct local message to another attached terminal by exact clientId.",
+    parameters: zod_1.z.object({}),
+    category: "arion",
+    riskLevel: "safe",
+    isReadOnly: true,
+    execute: async (_input, context) => {
+        const networkControl = context.networkControl;
+        const listAttachedClients = networkControl?.listAttachedClients;
+        if (!listAttachedClients) {
+            return {
+                success: false,
+                message: "Same-home client directory is not available for this runtime.",
+            };
+        }
+        const clients = await Promise.resolve(listAttachedClients());
+        const selfClient = clients.find((client) => client.self) ?? null;
+        const otherClients = clients.filter((client) => !client.self);
+        if (clients.length === 0) {
+            return {
+                success: true,
+                message: "No same-home attached clients are currently available.",
+                data: { clients: [], otherClients: [], selfClient: null },
+            };
+        }
+        return {
+            success: true,
+            message: otherClients.length > 0
+                ? `${otherClients.length} other same-home client(s) available`
+                : "No other same-home attached clients are currently available.",
+            data: { clients, otherClients, selfClient },
+        };
+    },
+});
+/** Network tool definitions (2) */
+exports.NETWORK_TOOL_DEFINITIONS = [manage_network, list_clients];
+//# sourceMappingURL=network.js.map

package/dist-cjs/definitions/network.js.map

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

package/dist-cjs/definitions/outlook.d.ts

@@ -0,0 +1,2 @@
+import type { Tool } from "../types.js";
+export declare const OUTLOOK_TOOL_DEFINITIONS: Tool[];