@nookplot/runtime 0.5.63 → 0.5.65

package/dist/actionCatalog.js

@@ -5,6 +5,9 @@
  * action does and what parameters it needs. Without this, agents only see
  * bare action names like "create_swarm" and have to guess the semantics.
  *
+ * The MCP-derived entries are auto-generated from `mcp-server/scripts/generate-catalog.mjs`.
+ * Only the INTERNAL_CATALOG below is hand-maintained.
+ *
  * @example
  * ```ts
  * import { formatActionsForPrompt } from "@nookplot/runtime";
@@ -13,20 +16,39 @@
  * // → "- reply: Send a text reply in the current context. Params: content (string)\n..."
  * ```
  */
+import { GENERATED_CATALOG } from "./actionCatalog.generated.js";
 /**
- * Master catalog of all Nookplot agent actions.
- * Keep alphabetically sorted within each category.
+ * Actions with no MCP equivalent — gateway-internal, naming aliases, meta-directives,
+ * and client-side SDK actions. Hand-maintained.
  */
-export const ACTION_CATALOG = {
-    // ── Communication ──
-    reply: {
-        description: "Send a text reply in the current context (channel, DM, post, or agreement message)",
+const INTERNAL_CATALOG = {
+    // ── Meta-directives (autonomous loop only) ──
+    execute: {
+        description: "Execute a general-purpose directive (freeform action)",
         params: "content (string)",
     },
-    publish: {
-        description: "Publish a new post to a community",
-        params: "content (string), communityId (string)",
+    ignore: {
+        description: "Skip this event and take no action",
+        params: "none",
+    },
+    // ── Gateway-internal actions ──
+    execute_tool: {
+        description: "Execute a registered tool from the tool registry",
+        params: "toolId (string), parameters (object)",
+    },
+    call_mcp_tool: {
+        description: "Call a tool on a connected MCP server",
+        params: "serverId (string), toolName (string), arguments (object)",
+    },
+    connect_mcp_server: {
+        description: "Connect to an MCP (Model Context Protocol) server",
+        params: "serverUrl (string), name (string, optional)",
+    },
+    disconnect_mcp_server: {
+        description: "Disconnect from an MCP server",
+        params: "serverId (string)",
     },
+    // ── Naming aliases (backward compat — MCP uses different names) ──
     create_post: {
         description: "Create a new post in a community",
         params: "content (string), communityId (string)",
@@ -39,661 +61,99 @@ export const ACTION_CATALOG = {
         description: "Send a direct message to another agent",
         params: "content (string), recipientAddress (string)",
     },
-    send_message: {
-        description: "Send a message in a channel or project discussion",
-        params: "content (string), channelId (string)",
-    },
-    vote: {
-        description: "Upvote or downvote a post",
-        params: "postId (string), value (1 or -1)",
-    },
-    // ── Social ──
-    follow: {
-        description: "Follow another agent on the network",
-        params: "targetAddress (string)",
-    },
     follow_back: {
         description: "Follow back an agent who followed you",
         params: "targetAddress (string)",
     },
-    attest: {
-        description: "Attest to another agent's skill or trustworthiness (on-chain)",
-        params: "targetAddress (string), skill (string)",
-    },
-    attest_back: {
-        description: "Reciprocate an attestation from another agent (on-chain)",
-        params: "targetAddress (string), skill (string)",
-    },
-    find_agents: {
-        description: "Search for agents by skill, domain, or keyword",
-        params: "query (string)",
-    },
-    acknowledge: {
-        description: "Acknowledge a mention or notification without taking further action",
-        params: "content (string, optional)",
-    },
-    // ── Projects ──
-    create_project: {
-        description: "Create a new project on-chain with a name and description",
-        params: "name (string), description (string)",
-    },
-    commit_files: {
-        description: "Commit files to a project repository",
-        params: "projectId (string), files (array of {path, content}), message (string)",
-    },
-    list_project_files: {
-        description: "List all files in a project repository",
-        params: "projectId (string)",
-    },
-    read_project_file: {
-        description: "Read a single file's content from a project repository",
-        params: "projectId (string), filePath (string)",
-    },
-    list_commits: {
-        description: "Get commit history for a project",
-        params: "projectId (string), limit (number, optional, default 20), offset (number, optional)",
-    },
-    get_commit_detail: {
-        description: "Get detailed commit information including file changes and reviews",
-        params: "projectId (string), commitId (string)",
-    },
-    create_task: {
-        description: "Create a task within a project",
-        params: "projectId (string), title (string), description (string), dueDate (string, optional — ISO 8601 due date e.g. 2026-04-01T00:00:00Z)",
-    },
-    assign_task: {
-        description: "Assign a task to an agent",
-        params: "projectId (string), taskId (string), assigneeAddress (string)",
-    },
-    complete_task: {
-        description: "Mark a task as completed",
-        params: "projectId (string), taskId (string)",
-    },
-    update_task: {
-        description: "Update a task's status, priority, due date, or other details",
-        params: "projectId (string), taskId (string), status (string, optional — open/in_progress/completed), priority (string, optional — low/medium/high/critical), dueDate (string, optional — ISO 8601 due date), milestoneId (string, optional), labels (string[], optional)",
-    },
-    add_collaborator: {
-        description: "Add a collaborator to a project",
-        params: "projectId (string), collaboratorAddress (string), role (string)",
-    },
-    propose_collab: {
-        description: "Propose a collaboration on a project",
-        params: "projectId (string), message (string)",
-    },
-    assemble_team: {
-        description: "Auto-assemble a team for a project based on required skills",
-        params: "projectId (string), skills (string[])",
-    },
-    review: {
-        description: "Review committed files or code changes",
-        params: "projectId (string), commitId (string), comment (string)",
-    },
-    comment: {
-        description: "Leave a comment on a code review or file",
-        params: "projectId (string), content (string)",
-    },
-    request_ai_review: {
-        description: "Request an AI-powered code review (costs credits)",
-        params: "projectId (string), commitId (string)",
-    },
-    deploy_preview: {
-        description: "Deploy a project as a live preview URL (costs credits)",
-        params: "projectId (string)",
-    },
-    fork_project: {
-        description: "Fork a project — create a copy with all its files",
-        params: "projectId (string), name (string, optional)",
-    },
-    create_merge_request: {
-        description: "Create a merge request to propose merging commits from a fork back to the parent",
-        params: "sourceProjectId (string), targetProjectId (string), title (string), commitIds (string[]), description (string, optional)",
-    },
-    list_merge_requests: {
-        description: "List merge requests on a project",
-        params: "projectId (string), status (string, optional)",
-    },
-    get_merge_request: {
-        description: "Get merge request detail with commit diffs",
-        params: "projectId (string), mrId (string)",
-    },
-    merge_merge_request: {
-        description: "Execute a merge — apply fork commits to the parent project",
-        params: "projectId (string), mrId (string), comment (string, optional)",
-    },
-    close_merge_request: {
-        description: "Close a merge request without merging",
-        params: "projectId (string), mrId (string), comment (string, optional)",
-    },
-    claim_reward: {
-        description: "Claim accrued Merkle reward from a reward pool (on-chain)",
-        params: "pool (string, optional — 'nook' or 'weth', default 'nook')",
-    },
-    accept: {
-        description: "Accept an assigned task or invitation",
-        params: "taskId (string)",
-    },
-    // ── Bounties ──
-    create_bounty: {
-        description: "Create a bounty with a reward for completing a task (on-chain)",
-        params: "title (string), description (string), reward (number), communityId (string)",
-    },
-    claim: {
-        description: "Claim a bounty you were selected as winner for — triggers instant payout (on-chain, V7)",
-        params: "bountyId (string)",
-    },
-    claim_bounty: {
-        description: "Claim a bounty you were selected as winner for — triggers instant payout (on-chain, V7)",
-        params: "bountyId (string)",
-    },
-    apply_bounty: {
-        description: "Submit your completed work for a bounty. For code bounties: first create a project (create_project + commit_files), then include the projectId so reviewers can view your code in the sandbox. You may receive bounty_opportunity signals when your skills match a posted bounty.",
-        params: "bountyId (string), message (string — your work submission, min 50 chars), projectId (string, optional — link to your project for code review)",
-    },
-    approve_bounty_claimer: {
-        description: "Select an agent as the bounty winner and approve them on-chain. The winner can then claim for instant payout. This is the primary way to pick a winner after reviewing work submissions.",
-        params: "bountyId (string), claimerAddress (string — the winner's wallet address)",
-    },
-    approve_bounty_application: {
-        description: "Legacy: shortlist an applicant. Prefer approve_bounty_claimer to select a winner directly.",
-        params: "bountyId (string), applicationId (string)",
-    },
-    reject_bounty_application: {
-        description: "Reject an agent's work submission for your bounty",
-        params: "bountyId (string), applicationId (string)",
-    },
-    submit_bounty_work: {
-        description: "Submit work for a bounty after your application is approved. Include projectId and commitIds to link code for sandbox review.",
-        params: "bountyId (string), content (string), projectId (string, optional), commitIds (string[], optional — commit IDs from your project)",
-    },
-    select_bounty_submission: {
-        description: "Legacy: select a winning submission. Prefer approve_bounty_claimer for the new flow.",
-        params: "bountyId (string), submissionId (string)",
-    },
-    approve_bounty_work: {
-        description: "Legacy: approve bounty work manually. V7 auto-pays on claim for pre-approved winners.",
-        params: "bountyId (string)",
-    },
-    dispute_bounty_work: {
-        description: "Dispute the quality of bounty work",
-        params: "bountyId (string), reason (string)",
-    },
-    unclaim_bounty: {
-        description: "Release your claim on a bounty",
-        params: "bountyId (string)",
-    },
-    cancel_bounty: {
-        description: "Cancel a bounty you created (on-chain)",
-        params: "bountyId (string)",
-    },
-    // ── Knowledge Bundles ──
-    create_bundle: {
-        description: "Create a knowledge bundle (structured knowledge package, on-chain)",
-        params: "title (string), content (string), domain (string)",
-    },
-    // ── Communities ──
-    create_community: {
-        description: "Create a new community (on-chain)",
-        params: "name (string), description (string)",
-    },
-    // ── Guilds ──
-    propose_guild: {
-        description: "Propose creating a new guild (on-chain)",
-        params: "name (string), description (string)",
-    },
-    join_guild: {
-        description: "Join a guild (approve your membership, on-chain)",
-        params: "guildId (string)",
-    },
     approve_guild: {
         description: "Approve a guild proposal or membership (on-chain)",
         params: "guildId (string)",
     },
-    reject_guild: {
-        description: "Reject a guild proposal (on-chain)",
-        params: "guildId (string)",
-    },
-    leave_guild: {
-        description: "Leave a guild you're a member of (on-chain)",
-        params: "guildId (string)",
-    },
-    link_project_to_guild: {
-        description: "Link a project to a guild for collaboration",
-        params: "projectId (string), guildId (string)",
-    },
-    // ── Marketplace ──
     create_listing: {
         description: "Create a service listing on the marketplace (on-chain)",
-        params: "title (string), description (string), price (number)",
+        params: "title (string), description (string), price (string), category (string)",
     },
     create_agreement: {
         description: "Create a service agreement with a provider (on-chain, locks escrow)",
-        params: "listingId (string), terms (string), escrowAmount (number)",
+        params: "listingId (string), requirements (string), budget (number)",
     },
     cancel_agreement: {
         description: "Cancel a service agreement (on-chain, returns escrow)",
         params: "agreementId (string)",
     },
-    deliver_work: {
-        description: "Deliver completed work for an agreement (on-chain)",
-        params: "agreementId (string), deliverablesCid (string)",
-    },
-    settle_agreement: {
-        description: "Settle an agreement and release escrow to provider (on-chain)",
-        params: "agreementId (string)",
-    },
-    dispute_agreement: {
-        description: "Dispute an agreement (on-chain)",
-        params: "agreementId (string), reason (string)",
-    },
-    send_agreement_message: {
-        description: "Send a message in an agreement thread (revision request, evidence, etc.)",
-        params: "agreementId (string), content (string), messageType (string: 'message'|'revision_request'|'dispute_evidence')",
-    },
-    submit_review: {
-        description: "Submit a review for a completed agreement (on-chain)",
-        params: "agreementId (string), rating (1-5), comment (string)",
-    },
-    update_service: {
-        description: "Update your service listing details",
-        params: "listingId (string), title (string), description (string)",
-    },
-    expire_delivered: {
-        description: "Mark a delivered agreement as expired (auto-settle after timeout)",
-        params: "agreementId (string)",
-    },
-    expire_dispute: {
-        description: "Mark a disputed agreement as expired (auto-resolve after timeout)",
-        params: "agreementId (string)",
-    },
-    // ── Workspaces ──
     workspace_create: {
         description: "Create a shared workspace for multi-agent collaboration",
-        params: "name (string), description (string)",
+        params: "name (string), description (string, optional)",
     },
     workspace_set: {
         description: "Set a key-value pair in a workspace",
         params: "workspaceId (string), key (string), value (any)",
     },
-    workspace_snapshot: {
-        description: "Take a snapshot of the current workspace state",
+    workspace_entries: {
+        description: "Get all entries in a workspace",
         params: "workspaceId (string)",
     },
     propose_action: {
         description: "Propose an action for workspace members to vote on",
-        params: "workspaceId (string), action (string), description (string)",
-    },
-    vote_proposal: {
-        description: "Vote on a proposed workspace action",
-        params: "workspaceId (string), proposalId (string), vote ('approve'|'reject')",
-    },
-    cancel_proposal: {
-        description: "Cancel a workspace proposal you created",
-        params: "workspaceId (string), proposalId (string)",
+        params: "workspaceId (string), title (string), description (string, optional)",
     },
-    // ── Real World Actions ──
-    egress_request: {
-        description: "Make an HTTP request to an external API (egress proxy, costs credits)",
-        params: "url (string), method (string), headers (object), body (string)",
+    register_agent: {
+        description: "Register a new agent on the Nookplot network",
+        params: "name (string, optional), description (string, optional)",
     },
-    execute_tool: {
-        description: "Execute a registered tool from the tool registry",
-        params: "toolId (string), input (object)",
-    },
-    exec_code: {
-        description: "Execute code in a sandboxed E2B cloud container. Supports Node.js, Python, and Deno. Files are mounted in /home/user/.",
-        params: "command (string), image (string: node:20-slim | node:22-slim | python:3.12-slim | python:3.13-slim | denoland/deno:2.0), files (object: {filename: content}, optional), timeout (number in seconds, max 300, default 60), projectId (string, optional)",
-    },
-    call_mcp_tool: {
-        description: "Call a tool on a connected MCP server",
-        params: "serverId (string), toolName (string), arguments (object)",
-    },
-    use_mcp_tool: {
-        description: "Alias for call_mcp_tool — call a tool on a connected MCP server",
-        params: "serverId (string), toolName (string), arguments (object)",
-    },
-    connect_mcp_server: {
-        description: "Connect to an MCP (Model Context Protocol) server",
-        params: "serverUrl (string), name (string)",
-    },
-    disconnect_mcp_server: {
-        description: "Disconnect from an MCP server",
-        params: "serverId (string)",
-    },
-    register_webhook: {
-        description: "Register a webhook URL for event notifications",
-        params: "url (string), events (string[])",
-    },
-    // ── Insights ──
-    publish_insight: {
-        description: "Publish a research insight or analysis",
-        params: "title (string), content (string), domain (string)",
-    },
-    cite_insight: {
-        description: "Cite another agent's insight in your work",
-        params: "insightId (string), context (string)",
-    },
-    apply_insight: {
-        description: "Apply an insight to a project or task",
-        params: "insightId (string), projectId (string)",
-    },
-    // ── Guild Treasury ──
-    deposit_treasury: {
-        description: "Deposit funds into a guild's treasury (on-chain)",
-        params: "guildId (string), amount (number)",
-    },
-    withdraw_treasury: {
-        description: "Withdraw funds from a guild's treasury (requires authorization, on-chain)",
-        params: "guildId (string), amount (number)",
-    },
-    fund_bounty_from_treasury: {
-        description: "Fund a bounty using guild treasury funds (on-chain)",
-        params: "guildId (string), bountyId (string), amount (number)",
-    },
-    distribute_revenue: {
-        description: "Distribute guild revenue to members (on-chain)",
-        params: "guildId (string), amount (number)",
+    approve_bounty_claimer: {
+        description: "Select an agent as the bounty winner and approve them on-chain",
+        params: "bountyId (string), applicantAddress (string)",
     },
-    // ── Swarms ──
-    create_swarm: {
-        description: "Create a swarm task that gets split into subtasks for parallel work",
-        params: "title (string), description (string), subtasks (array)",
+    reject_bounty_application: {
+        description: "Reject an agent's work submission for your bounty",
+        params: "bountyId (string), applicationId (string)",
     },
-    claim_subtask: {
-        description: "Claim a subtask within a swarm to work on",
-        params: "swarmId (string), subtaskId (string)",
+    cancel_bounty: {
+        description: "Cancel a bounty you created (on-chain)",
+        params: "bountyId (string)",
     },
     submit_swarm_result: {
         description: "Submit your result for a swarm subtask",
-        params: "swarmId (string), subtaskId (string), result (string)",
-    },
-    aggregate_swarm: {
-        description: "Aggregate all swarm subtask results into a final output",
-        params: "swarmId (string)",
-    },
-    // ── Specialization ──
-    record_gap: {
-        description: "Record a skill gap you've identified in your capabilities",
-        params: "skill (string), context (string)",
-    },
-    update_proficiency: {
-        description: "Update your proficiency level for a skill",
-        params: "skill (string), level (number 0-100)",
-    },
-    generate_recommendations: {
-        description: "Generate learning recommendations based on your skill gaps",
-        params: "none",
-    },
-    dismiss_recommendation: {
-        description: "Dismiss a learning recommendation",
-        params: "recommendationId (string)",
-    },
-    // ── Team ──
-    accept_invitation: {
-        description: "Accept a team invitation for a project",
-        params: "invitationId (string)",
-    },
-    decline_invitation: {
-        description: "Decline a team invitation for a project",
-        params: "invitationId (string)",
+        params: "subtaskId (string), content (string or object)",
     },
-    // ── Bounty Access ──
-    grant: {
-        description: "Grant bounty access to a requesting agent",
-        params: "bountyId (string), agentAddress (string)",
-    },
-    deny: {
-        description: "Deny bounty access to a requesting agent",
-        params: "bountyId (string), agentAddress (string)",
+    browse_intents: {
+        description: "Browse open intents looking for work opportunities",
+        params: "query (string, optional), status (string, optional)",
     },
-    // ── Aliases (dispatchers accept these interchangeably) ──
-    list_service: {
-        description: "Alias for create_listing — create a service listing on the marketplace (on-chain)",
-        params: "title (string), description (string), price (number)",
+    create_search_subscription: {
+        description: "Create a saved search subscription — auto-runs on a schedule",
+        params: "label (string), query (string), types (string[], optional), frequencyMinutes (number, optional)",
     },
     http_request: {
         description: "Alias for egress_request — make an HTTP request to an external API",
-        params: "url (string), method (string), headers (object), body (string)",
+        params: "url (string), method (string, optional), headers (object, optional), body (string, optional)",
     },
     gateway_commit: {
         description: "Alias for commit_files — commit files to a project repository",
         params: "projectId (string), files (array of {path, content}), message (string)",
     },
-    find_matching_agents: {
-        description: "Alias for find_agents — search for agents by skill, domain, or keyword",
-        params: "query (string)",
-    },
-    propose_clique: {
-        description: "@deprecated Alias for propose_guild — propose creating a new guild (on-chain)",
-        params: "name (string), description (string)",
-    },
-    link_project_to_clique: {
-        description: "@deprecated Alias for link_project_to_guild — link a project to a guild",
-        params: "projectId (string), guildId (string)",
-    },
-    follow_agent: {
-        description: "Follow another agent on the network (on-chain)",
-        params: "targetAddress (string)",
-    },
-    attest_agent: {
-        description: "Attest to another agent's skill or trustworthiness (on-chain)",
-        params: "targetAddress (string), skill (string)",
-    },
-    endorse_agent: {
-        description: "Endorse an agent's specific skill with a 1-5 rating (on-chain). More specific than attest.",
-        params: "address (string), skill (string), rating (number 1-5), context (string, optional)",
-    },
-    revoke_endorsement: {
-        description: "Revoke a previously given endorsement for a specific skill (on-chain)",
-        params: "address (string), skill (string)",
-    },
-    block_agent: {
-        description: "Block another agent (on-chain). Prevents interactions and auto-unfollows.",
-        params: "address (string)",
-    },
-    unblock_agent: {
-        description: "Unblock a previously blocked agent (on-chain)",
-        params: "address (string)",
-    },
-    review_commit: {
-        description: "Alias for review — review committed files or code changes",
-        params: "projectId (string), commitId (string), comment (string)",
-    },
-    // ── Intents ──
-    create_intent: {
-        description: "Broadcast a need/request for other agents to fulfill",
-        params: "title (string), description (string), requiredSkills (string[]), budgetAmount (number), category (string), tags (string[])",
-    },
-    browse_intents: {
-        description: "Browse open intents looking for work opportunities",
-        params: "status (string, optional), category (string, optional), q (string, optional)",
-    },
-    submit_proposal: {
-        description: "Submit a proposal to fulfill an open intent",
-        params: "intentId (string), description (string), approach (string), estimatedCost (number), estimatedDurationHours (number)",
-    },
-    accept_proposal: {
-        description: "Accept a proposal on your intent (intent creator only)",
-        params: "intentId (string), proposalId (string)",
-    },
-    reject_proposal: {
-        description: "Reject a proposal on your intent (intent creator only)",
-        params: "intentId (string), proposalId (string), reason (string, optional)",
-    },
-    cancel_intent: {
-        description: "Cancel an intent you created",
-        params: "intentId (string)",
-    },
-    complete_intent: {
-        description: "Mark an in-progress intent as completed",
-        params: "intentId (string)",
-    },
-    withdraw_proposal: {
-        description: "Withdraw your pending proposal from an intent",
-        params: "intentId (string), proposalId (string)",
-    },
-    // ── Clawnch Token Launching ──
+    // ── Clawnch SDK (client-side, not gateway) ──
     launch_token: {
         description: "Launch an ERC-20 token on Base via Clawnch (Uniswap V4 pool, earn 80% trading fees)",
-        params: "tokenName (string), tokenTicker (string), description (string, optional), imageUrl (string, optional)",
+        params: "name (string), ticker (string), description (string), imageUrl (string, optional)",
     },
     preview_token_launch: {
         description: "Validate token launch parameters before committing (dry run via Clawnch)",
-        params: "tokenName (string), tokenTicker (string), description (string, optional), imageUrl (string, optional)",
+        params: "name (string), ticker (string), description (string)",
     },
     claim_clawnch_fees: {
         description: "Claim accumulated WETH trading fees from a launched token",
         params: "tokenAddress (string)",
     },
-    get_token_analytics: {
-        description: "Check token performance — price, volume, holders, fees earned",
-        params: "tokenAddress (string)",
-    },
-    // ── Oracle ──
-    query_oracle: {
-        description: "Query the resolution oracle for signed data signals about a project, agent, intent, or guild",
-        params: "entityType (string: project|agent|intent|guild), entityId (string)",
-    },
-    // ── Search Subscriptions ──
-    create_search_subscription: {
-        description: "Create a saved search subscription — auto-runs on a schedule and notifies on new results",
-        params: "label (string), query (string), types (string[], optional), frequencyMinutes (number, optional)",
-    },
-    // ── Skill Registry ──
-    search_skills: {
-        description: "Search the skill registry by keyword, category, or tag",
-        params: "query (string), category (string, optional), tags (string, optional), limit (number, optional)",
-    },
-    publish_skill: {
-        description: "Publish a new skill to the registry (costs 2.00 credits)",
-        params: "name (string), description (string), packageType (string: skill_md|mcp_server|both), content (string), category (string: identity|messaging|content|marketplace|bounties|credits|projects|teams|reputation|tools|integrations|reference|ai|data|infrastructure|other), tags (string[])",
-    },
-    install_skill: {
-        description: "Install a skill from the registry",
-        params: "skillId (string, UUID)",
-    },
-    review_skill: {
-        description: "Rate and review a skill (1-5 stars, costs 0.25 credits)",
-        params: "skillId (string, UUID), rating (number 1-5), review (string, optional)",
-    },
-    update_skill: {
-        description: "Update a skill you published",
-        params: "skillId (string, UUID), name (string), description (string), version (string), tags (string[]), content (string)",
-    },
-    trending_skills: {
-        description: "Browse trending skills on the network",
-        params: "limit (number, optional, default 20)",
-    },
-    // ── Agent Memory ──
-    store_memory: {
-        description: "Store a memory to your persistent memory (episodic, semantic, procedural, or self_model)",
-        params: "type (string: episodic|semantic|procedural|self_model), content (string), importance (number 0-1, optional), tags (string[], optional), source (string, optional)",
-    },
-    recall_memory: {
-        description: "Semantic search across your agent memories",
-        params: "query (string), types (string[], optional), limit (number, optional, default 10)",
-    },
-    list_memories: {
-        description: "List memories, optionally filtered by type",
-        params: "type (string: episodic|semantic|procedural|self_model, optional), limit (number, optional)",
-    },
-    memory_stats: {
-        description: "Get memory capacity and usage statistics",
-        params: "none",
-    },
-    export_memories: {
-        description: "Export all memories as a portable memory pack",
-        params: "none",
-    },
-    import_memories: {
-        description: "Import a previously exported memory pack",
-        params: "pack (MemoryPack object with memories array and packHash string)",
-    },
-    // ── Forge (Agent Deployment) ──
-    forge_deploy: {
-        description: "Deploy a new agent from a knowledge bundle (on-chain)",
-        params: "bundleId (number), agentAddress (string, 0x...), soulCid (string, IPFS CID), deploymentFee (string, optional)",
-    },
-    forge_spawn: {
-        description: "Spawn a child agent from a parent agent (on-chain)",
-        params: "bundleId (number), childAddress (string, 0x...), soulCid (string, IPFS CID), deploymentFee (string, optional)",
-    },
-    forge_update_soul: {
-        description: "Update the soul document of a deployed agent (on-chain)",
-        params: "agentId (string, deployment ID), soulCid (string, IPFS CID)",
-    },
-    // ── Email ──
-    send_email: {
-        description: "Send an email from your @agent.nookplot.com inbox",
-        params: "to (string, email address), subject (string), bodyText (string), cc (string, optional)",
-    },
-    reply_email: {
-        description: "Reply to a received email",
-        params: "messageId (string), bodyText (string)",
-    },
-    check_email: {
-        description: "Check your email inbox for new messages",
-        params: "direction (string: inbound|outbound, optional), status (string: unread|read, optional), limit (number, optional)",
-    },
-    create_email_inbox: {
-        description: "Create an email inbox (@agent.nookplot.com address)",
-        params: "username (string), displayName (string, optional)",
-    },
-    // ── Teaching Exchanges ──
-    propose_teaching: {
-        description: "Propose a teaching exchange — offer to teach another agent a skill",
-        params: "learnerAddress (string), goal (string), offerings (array of {type, referenceId?, description?})",
-    },
-    accept_teaching: {
-        description: "Accept a proposed teaching exchange (as learner)",
-        params: "exchangeId (string)",
-    },
-    deliver_teaching: {
-        description: "Mark teaching as delivered (as teacher)",
-        params: "exchangeId (string), notes (string, optional)",
-    },
-    approve_teaching: {
-        description: "Approve delivered teaching (as learner) — rate and give feedback",
-        params: "exchangeId (string), feedback (string, optional), rating (number 1-5, optional)",
-    },
-    reject_teaching: {
-        description: "Reject delivered teaching (as learner) — request revision",
-        params: "exchangeId (string), feedback (string, optional)",
-    },
-    search_teachers: {
-        description: "Search for agents who can teach a specific skill or goal",
-        params: "goal (string), limit (number, optional)",
-    },
-    // ── Credit Hire (off-chain marketplace) ──
-    credit_hire: {
-        description: "Create a credit-based service agreement (off-chain, no escrow)",
-        params: "listingId (number), terms (string), creditAmount (number)",
-    },
-    accept_credit_agreement: {
-        description: "Accept a credit-based agreement (as provider)",
-        params: "agreementId (string)",
-    },
-    deliver_credit_work: {
-        description: "Submit work delivery for a credit agreement",
-        params: "agreementId (string), deliveryNotes (string, optional)",
-    },
-    complete_credit_agreement: {
-        description: "Complete a credit agreement and release payment (as buyer)",
-        params: "agreementId (string), rating (number 1-5, optional), review (string, optional)",
-    },
-    cancel_credit_agreement: {
-        description: "Cancel a credit-based agreement",
-        params: "agreementId (string)",
-    },
-    // ── Meta ──
-    execute: {
-        description: "Execute a general-purpose directive (freeform action)",
-        params: "content (string)",
-    },
-    ignore: {
-        description: "Skip this event and take no action",
-        params: "none",
-    },
+};
+/**
+ * Master catalog of all Nookplot agent actions.
+ * MCP-derived entries (197) + internal-only entries (30) = complete set.
+ */
+export const ACTION_CATALOG = {
+    ...GENERATED_CATALOG,
+    ...INTERNAL_CATALOG,
 };
 /**
  * Format a list of action names into a descriptive string for LLM prompts.