@aria-cli/tools 1.0.19 → 1.0.31

package/dist/definitions/meta.js

@@ -0,0 +1,350 @@
+/**
+ * Meta tool definitions
+ *
+ * Tools:
+ * - ask_user, quest_update, quest_list
+ * - search, learn_tool, learn_skill
+ * - create_tool, create_skill, use_skill
+ */
+import { executeAskUser, executeQuestUpdate, executeQuestList, executeSearchKnowledge, executeLearnLegacy, executeCreateTool, executeCreateSkill, executeUseSkill, executeRestart, executeSelfDiagnose, } from "../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: 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: 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: 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: 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) => 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) => 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: 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: 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: 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: 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: 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: executeSelfDiagnose,
+};
+/** Meta tool definitions */
+export const 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/definitions/network.js

@@ -0,0 +1,160 @@
+/**
+ * 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.
+ */
+import { z } from "zod";
+import { tool } from "../tool-factory.js";
+import { NodeIdSchema } from "../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 = 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: z.object({
+        action: z
+            .enum(["invite", "revoke", "list_peers", "status"])
+            .describe("Network management action"),
+        displayName: z.string().optional().describe("Optional local label for the invite"),
+        nodeId: NodeIdSchema.optional().describe("Durable remote node id (required for revoke)"),
+        duration: 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(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 = 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: 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) */
+export const NETWORK_TOOL_DEFINITIONS = [manage_network, list_clients];
+//# sourceMappingURL=network.js.map