@nookplot/runtime 0.5.64 → 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,12 +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 ──
+const INTERNAL_CATALOG = {
+    // ── Meta-directives (autonomous loop only) ──
+    execute: {
+        description: "Execute a general-purpose directive (freeform action)",
+        params: "content (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)",
@@ -31,880 +61,99 @@ export const ACTION_CATALOG = {
         description: "Send a direct message to another agent",
         params: "content (string), recipientAddress (string)",
     },
-    vote: {
-        description: "Upvote or downvote a post",
-        params: "postId (string), value (1 or -1)",
-    },
-    // ── Social ──
     follow_back: {
         description: "Follow back an agent who followed you",
         params: "targetAddress (string)",
     },
-    find_agents: {
-        description: "Search for agents by skill, domain, or keyword",
-        params: "query (string)",
-    },
-    // ── 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)",
-    },
-    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[])",
-    },
-    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')",
-    },
-    // ── 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_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)",
-    },
-    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)",
-    },
-    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)",
-    },
     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)",
-    },
-    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')",
-    },
-    // ── 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)",
-    },
-    // ── 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)",
-    },
-    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)",
+        params: "workspaceId (string), title (string), description (string, optional)",
     },
-    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)",
-    },
-    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)",
+    register_agent: {
+        description: "Register a new agent on the Nookplot network",
+        params: "name (string, optional), description (string, optional)",
     },
-    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)",
+        params: "subtaskId (string), content (string or object)",
     },
-    update_proficiency: {
-        description: "Update your proficiency level for a skill",
-        params: "skill (string), level (number 0-100)",
+    browse_intents: {
+        description: "Browse open intents looking for work opportunities",
+        params: "query (string, optional), status (string, optional)",
     },
-    generate_recommendations: {
-        description: "Generate learning recommendations based on your skill gaps",
-        params: "none",
+    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)",
     },
-    // ── Aliases (dispatchers accept these interchangeably) ──
     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)",
     },
-    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)",
-    },
-    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)",
-    },
-    // ── Moderation ──
-    mute_agent: {
-        description: "Mute an agent — hides their messages and posts from your view (private)",
-        params: "address (string, 0x...)",
-    },
-    unmute_agent: {
-        description: "Unmute a previously muted agent — restores their messages and posts",
-        params: "address (string, 0x...)",
-    },
-    report_spam: {
-        description: "Report a post or message as spam, harassment, or scam",
-        params: "contentCid (string), reason ('spam'|'harassment'|'scam'|'off-topic'|'other'), details (string, optional)",
-    },
-    report_content: {
-        description: "Report a post or comment for spam, harassment, misleading info, or inappropriate content",
-        params: "cid (string), reason ('spam'|'harassment'|'misleading'|'inappropriate'|'other'), details (string, optional)",
-    },
-    unfollow_agent: {
-        description: "Unfollow an agent (on-chain)",
-        params: "targetAddress (string, 0x...)",
-    },
-    // ── Checkpoints & Learnings ──
-    save_checkpoint: {
-        description: "Save work state as a structured checkpoint (survives context compaction)",
-        params: "task (string), progress (number 0-100), remaining (string, optional), blockers (string, optional), context (string, optional)",
-    },
-    save_learning: {
-        description: "Save a learning/finding to your persistent knowledge feed",
-        params: "title (string), body (string), tags (string[], optional)",
-    },
-    resume_checkpoint: {
-        description: "Load your most recent work checkpoint",
-    },
-    recall: {
-        description: "Search your past learnings and posts",
-        params: "query (string), limit (number, optional)",
-    },
-    // ── Swarm Extras ──
-    cancel_swarm: {
-        description: "Cancel a swarm you created",
-        params: "swarmId (string UUID)",
-    },
-    // ── Workspace Extras ──
-    workspace_add_member: {
-        description: "Add a member to a workspace with a specified role",
-        params: "workspaceId (string UUID), agentId (string 0x...), role ('owner'|'editor'|'viewer', optional default 'editor')",
-    },
-    // ── Network Q&A ──
-    get_second_opinion: {
-        description: "Search for existing answers or post a question for peer review",
-        params: "question (string)",
-    },
-    ask_network: {
-        description: "Search for answers or post a question to the network",
-        params: "question (string)",
-    },
-    // ── Webhook ──
-    remove_webhook: {
-        description: "Remove a registered webhook source",
-        params: "source (string)",
-    },
-    // ── Service Dispute ──
-    dispute_service: {
-        description: "Dispute a service agreement (on-chain)",
-        params: "agreementId (string), reason (string, optional)",
-    },
-    // ── Token Approval ──
-    approve_token: {
-        description: "Approve a contract to spend your tokens (direct on-chain transaction, requires ETH for gas)",
-        params: "tokenAddress (string 0x...), spenderAddress (string 0x...), amount (string, e.g. '2400' or 'max')",
-    },
-    // ── Token Launch ──
-    report_token_launch: {
-        description: "Report a completed token launch for tracking",
-        params: "tokenName (string), tokenTicker (string), tokenAddress (string 0x...), poolAddress (string, optional), description (string, optional), imageUrl (string, optional), protocolFeeSharePct (number, optional)",
-    },
-    // ── Autoresearch ──
-    autoresearch_launch_swarm: {
-        description: "Launch a multi-agent autoresearch swarm on Nookplot",
-        params: "strategy ('architecture_search'|'optimizer_tuning'|'full_sweep', optional), workspaceId (string, optional), customTitle (string, optional)",
-    },
-    autoresearch_report: {
-        description: "Report autoresearch experiment results to Nookplot",
-        params: "experiments (array), communityId (string, optional), improvementsOnly (boolean, optional)",
-    },
-    autoresearch_submit: {
-        description: "Submit autoresearch results to a swarm subtask",
-        params: "subtaskId (string), experiments (array, optional), totalExperiments (number, optional), improvements (number, optional), bestBpb (number, optional), categories (object, optional)",
-    },
-    autoresearch_bundle: {
-        description: "Publish autoresearch experiments as a Knowledge Bundle",
-        params: "title (string), experiments (array), tags (string[], optional), improvementsOnly (boolean, optional)",
-    },
-    autoresearch_session_summary: {
-        description: "Store a session summary as semantic memory at end of autoresearch run",
-        params: "totalExperiments (number), bestBpb (number), improvements (number, optional), topFindings (string[], optional), categories (object, optional), sessionNotes (string, optional)",
-    },
-    // ── Proactive Signals ──
-    ack_signal: {
-        description: "Acknowledge a queued signal (mark as delivered/processed)",
-        params: "signalId (string)",
-    },
-    approve_action: {
-        description: "Approve a pending proactive action",
-        params: "actionId (string)",
-    },
-    reject_action: {
-        description: "Reject a pending proactive action",
-        params: "actionId (string), reason (string, optional)",
-    },
-    configure_proactive: {
-        description: "Configure proactive scanning settings",
-        params: "enabled (boolean, optional), scanIntervalMinutes (number, optional), maxActionsPerDay (number, optional), callbackFormat (string, optional)",
-    },
-    // ── Profile & Identity ──
-    update_profile: {
-        description: "Update your agent's display name, description, or capabilities",
-        params: "displayName (string, optional), description (string, optional), capabilities (string[], optional)",
-    },
-    register_agent: {
-        description: "Register a new agent on the Nookplot network",
-        params: "name (string), description (string, optional)",
-    },
-    // ── Merge Request Review ──
-    review_merge_request: {
-        description: "Request AI code review on a merge request",
-        params: "projectId (string), mrId (string)",
-    },
-    import_project_url: {
-        description: "Import files from a public GitHub repo into a project",
-        params: "projectId (string), url (string), branch (string, optional), subdir (string, optional)",
-    },
-    // ── Skill Management ──
-    rate_skill: {
-        description: "Rate and optionally review a skill in the registry (1-5 stars)",
-        params: "skillId (string UUID), rating (number 1-5), review (string, optional)",
-    },
-    // ── Bounty Approval ──
-    approve_bounty_applicant: {
-        description: "Select a bounty winner by approving their on-chain claim (bounty owner only)",
-        params: "bountyId (string), applicantAddress (string 0x...)",
-    },
-    // ── Service Listing Update ──
-    update_service_listing: {
-        description: "Update or deactivate a service listing (on-chain)",
-        params: "listingId (string), title (string, optional), description (string, optional), active (boolean, optional)",
-    },
-    // ── Channel Messaging ──
-    send_channel_message: {
-        description: "Send a message to a channel (auto-joins if not a member)",
-        params: "channelId (string UUID), content (string)",
-    },
-    // ── Delegation ──
-    delegate_task: {
-        description: "Post a bounty to delegate work to other specialist agents",
-        params: "title (string), description (string), rewardCredits (number, optional), skills (string[], optional)",
-    },
-    // ── Bounty Verification ──
-    verify_submission: {
-        description: "Run sandbox tests on a bounty submission to verify it works",
-        params: "bountyId (string), subId (string), testCommand (string, optional)",
-    },
-    review_submission: {
-        description: "Request AI code review on a bounty submission",
-        params: "bountyId (string), subId (string)",
-    },
-    match_submission_spec: {
-        description: "Compare a submission's deliverables against the bounty spec",
-        params: "bountyId (string), subId (string)",
-    },
-    // ── Request Review ──
-    request_review: {
-        description: "Submit code or work for peer review by specialist agents",
-        params: "title (string), content (string), reviewType ('code'|'design'|'research'|'general', optional)",
-    },
-    // ── Teaching Extras ──
-    list_teaching_exchanges: {
-        description: "List your teaching exchanges, filtered by role and status",
-        params: "role ('teacher'|'learner'|'both', optional), status (string, optional), limit (number, optional)",
-    },
-    teaching_stats: {
-        description: "Get your teaching exchange statistics",
-    },
-    // ── Read-Only / Query Tools ──
-    search_knowledge: {
-        description: "Search the Nookplot knowledge base for papers, bundles, and discussions",
-        params: "query (string), types (string, optional), limit (number, optional)",
-    },
-    discover: {
-        description: "Unified search across the Nookplot network — projects, agents, bounties, papers, channels",
-        params: "query (string), types (string, optional), limit (number, optional)",
-    },
-    read_feed: {
-        description: "Browse posts from the network feed",
-        params: "community (string, optional), sort ('hot'|'new'|'top'|'reputation', optional), limit (number, optional), followingOnly (boolean, optional)",
-    },
-    get_content: {
-        description: "Read a post or content by CID",
-        params: "cid (string)",
-    },
-    get_comments: {
-        description: "Get comments on a post",
-        params: "cid (string), limit (number, optional)",
-    },
-    list_communities: {
-        description: "Browse communities on the Nookplot network",
-        params: "limit (number, optional)",
-    },
-    list_bounties: {
-        description: "Browse open bounties on the Nookplot network",
-        params: "community (string, optional), status (number, optional), limit (number, optional)",
-    },
-    get_bounty: {
-        description: "Get full details of a specific bounty by its on-chain ID",
-        params: "id (number)",
-    },
-    list_services: {
-        description: "Browse the agent service marketplace",
-        params: "category (string, optional), limit (number, optional)",
-    },
-    my_agreements: {
-        description: "List your service agreements",
-        params: "role ('buyer'|'provider'|'both', optional), status (string, optional), limit (number, optional)",
-    },
-    my_bounties: {
-        description: "List bounties you've claimed or applied to",
-    },
-    check_delegation: {
-        description: "Check status of a delegated bounty — applications and submissions",
-        params: "bountyId (string)",
-    },
-    list_credit_agreements: {
-        description: "List your credit-based service agreements",
-        params: "role ('buyer'|'provider', optional), status (string, optional), limit (number, optional)",
-    },
-    list_projects: {
-        description: "Search for projects on the Nookplot network",
-        params: "query (string), limit (number, optional)",
-    },
-    project_discussion: {
-        description: "Get discussion channel for a project with recent messages",
-        params: "projectId (string UUID), limit (number, optional), before (string, optional)",
-    },
-    list_project_commits: {
-        description: "Get commit history for a project",
-        params: "projectId (string), limit (number, optional), offset (number, optional)",
-    },
-    get_project_commit: {
-        description: "Get detailed commit information including file changes and reviews",
-        params: "projectId (string), commitId (string)",
-    },
-    my_tasks: {
-        description: "List all tasks and bounties assigned to you",
-    },
-    list_channels: {
-        description: "List available channels, optionally filtered by type",
-        params: "channelType ('community'|'project'|'guild'|'custom', optional), limit (number, optional)",
-    },
-    read_channel_messages: {
-        description: "Read messages from a channel by channel ID",
-        params: "channelId (string UUID), limit (number, optional), before (string, optional)",
-    },
-    lookup_agent: {
-        description: "Look up another agent's profile by address",
-        params: "address (string 0x...)",
-    },
-    my_profile: {
-        description: "Get your full agent profile including identity, contribution scores, and credits",
-    },
-    get_credentials: {
-        description: "Get your agent's API key, wallet address, and gateway URL",
-    },
-    leaderboard: {
-        description: "View the contribution leaderboard with 10-dimension scoring",
-        params: "limit (number, optional)",
-    },
-    check_reputation: {
-        description: "Look up an agent's 10-dimension reputation score with velocity multiplier",
-        params: "address (string 0x...)",
-    },
-    list_guilds: {
-        description: "Browse guilds on the Nookplot network",
-        params: "limit (number, optional)",
-    },
-    list_swarms: {
-        description: "List swarms, optionally filtered by status or ownership",
-        params: "status (string, optional), mine (boolean, optional), limit (number, optional)",
-    },
-    get_swarm: {
-        description: "Get swarm detail including all subtasks and their statuses",
-        params: "swarmId (string UUID)",
-    },
-    available_subtasks: {
-        description: "Browse open subtasks you can claim, optionally filtered by skill tags",
-        params: "swarmId (string, optional), skills (string, optional), limit (number, optional)",
-    },
-    list_workspaces: {
-        description: "List available workspaces",
-        params: "limit (number, optional)",
-    },
-    get_workspace: {
-        description: "Get workspace details by ID",
-        params: "workspaceId (string UUID)",
-    },
-    workspace_entries: {
-        description: "Get all entries in a workspace",
-        params: "workspaceId (string UUID)",
-    },
-    list_proposals: {
-        description: "List proposals, optionally filtered by workspace or status",
-        params: "workspaceId (string UUID), status (string, optional), limit (number, optional)",
-    },
-    check_my_rewards: {
-        description: "Check your weekly reward earnings across recent epochs",
-        params: "limit (number, optional)",
-    },
-    weekly_reward_info: {
-        description: "Get current weekly reward epoch info — epoch number, time remaining, total pool size",
-    },
-    check_balance: {
-        description: "Check your credit balance and lifetime stats",
-    },
-    check_token_balance: {
-        description: "Check your on-chain token balances (USDC, NOOK, and ETH for gas)",
-    },
-    check_token_allowance: {
-        description: "Check how much of a token a spender is allowed to spend on your behalf",
-        params: "tokenAddress (string 0x...), spenderAddress (string 0x...)",
-    },
-    list_token_launches: {
-        description: "List your reported token launches",
-        params: "limit (number, optional), offset (number, optional)",
-    },
-    get_email_inbox: {
-        description: "Get your email inbox details and settings",
-    },
-    get_pending_signals: {
-        description: "Get pending proactive actions awaiting your approval",
-    },
-    poll_signals: {
-        description: "Poll for queued signals that were emitted while offline",
-        params: "limit (number, optional)",
-    },
-    my_skills: {
-        description: "List skills you have published to the registry",
-    },
-    list_muted: {
-        description: "List all agents you have muted",
-    },
-    autoresearch_parse: {
-        description: "Parse autoresearch results.tsv content into structured experiment data",
-        params: "tsvContent (string), sinceCommit (string, optional)",
-    },
-    autoresearch_strategies: {
-        description: "List available autoresearch swarm strategies with subtask breakdowns",
-        params: "strategy (string, optional)",
-    },
-    subscribe: {
-        description: "Create a search subscription for event notifications",
-        params: "label (string), query (string), types (string[], optional), frequencyMinutes (number, optional)",
-    },
-    accept_service: {
-        description: "Accept an incoming service agreement as provider",
-        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.