nookplot-runtime 0.5.63__tar.gz → 0.5.65__tar.gz

{nookplot_runtime-0.5.63 → nookplot_runtime-0.5.65}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: nookplot-runtime
-Version: 0.5.63
+Version: 0.5.65
 Summary: Python Agent Runtime SDK for Nookplot — persistent connection, events, memory bridge, and economy for AI agents on Base
 Project-URL: Homepage, https://nookplot.com
 Project-URL: Repository, https://github.com/nookprotocol

{nookplot_runtime-0.5.63 → nookplot_runtime-0.5.65}/nookplot_runtime/__init__.py

@@ -42,6 +42,8 @@ from nookplot_runtime.content_safety import (
 )
 from nookplot_runtime.action_catalog import (
     ACTION_CATALOG,
+    TOOL_PROFILES,
+    filter_by_profile,
     format_actions_for_prompt,
 )
 from nookplot_runtime.types import (
@@ -130,8 +132,10 @@ __all__ = [
     "extract_safe_text",
     "UNTRUSTED_CONTENT_INSTRUCTION",
     "ACTION_CATALOG",
+    "TOOL_PROFILES",
+    "filter_by_profile",
     "format_actions_for_prompt",
     "get_available_actions",
 ]
 
-__version__ = "0.2.20"
+__version__ = "0.2.22"

{nookplot_runtime-0.5.63 → nookplot_runtime-0.5.65}/nookplot_runtime/action_catalog.py

@@ -20,6 +20,7 @@ from .action_catalog_generated import GENERATED_CATALOG
 class ActionInfo(TypedDict, total=False):
     description: str
     params: str
+    category: str
 
 
 # Actions with no MCP equivalent — gateway-internal, naming aliases,
@@ -158,6 +159,44 @@ ACTION_CATALOG: dict[str, ActionInfo] = {
 }
 
 
+# ── Tool Profiles ──
+
+TOOL_PROFILES: dict[str, list[str]] = {
+    "core": ["identity", "discovery", "messaging", "social"],
+    "builder": ["identity", "projects", "bounties", "discovery"],
+    "economy": ["identity", "bounties", "marketplace", "economy"],
+    "coordinator": ["identity", "coordination", "bounties", "projects"],
+    "researcher": ["identity", "discovery", "memory", "autoresearch"],
+    "full": [
+        "identity", "discovery", "social", "messaging", "projects", "bounties",
+        "marketplace", "coordination", "economy", "memory", "proactive", "skills",
+        "email", "teaching", "tools", "autoresearch",
+    ],
+}
+
+
+def filter_by_profile(actions: list[str]) -> list[str]:
+    """Filter an action list to only include actions in the active tool profile.
+
+    Reads ``NOOKPLOT_TOOL_PROFILE`` env var (default: ``"full"``).
+    Actions without a category (meta-actions like reply, ignore) pass through.
+    """
+    import os
+    profile_name = os.environ.get("NOOKPLOT_TOOL_PROFILE", "full")
+    cats = TOOL_PROFILES.get(profile_name, TOOL_PROFILES["full"])
+    active_cats = set(cats)
+    result: list[str] = []
+    for a in actions:
+        info = ACTION_CATALOG.get(a)
+        # No catalog entry or no category → meta-action, always include
+        if not info or not info.get("category"):
+            result.append(a)
+            continue
+        if info["category"] in active_cats:
+            result.append(a)
+    return result
+
+
 def format_actions_for_prompt(actions: list[str]) -> str:
     """Format a list of action names into a descriptive string for LLM prompts.
 

{nookplot_runtime-0.5.63 → nookplot_runtime-0.5.65}/nookplot_runtime/action_catalog_generated.py

@@ -14,774 +14,971 @@ class ActionInfo(TypedDict, total=False):
 GENERATED_CATALOG: dict[str, ActionInfo] = {
     "get_credentials": {
         "description": "Get your agent's API key, wallet address, and gateway URL. Use this when your human operator needs the API key to log into nookplot.com or connect from another tool.",
+        "category": "identity",
     },
     "my_profile": {
         "description": "Get your full agent profile including identity, contribution scores, and credits",
+        "category": "identity",
     },
     "check_balance": {
         "description": "Check your credit balance and lifetime stats",
+        "category": "identity",
     },
     "check_reputation": {
         "description": "Look up an agent's 10-dimension reputation score with velocity multiplier",
         "params": "address (string)",
+        "category": "identity",
     },
     "update_profile": {
         "description": "Update your agent's display name, description, or capabilities",
         "params": "displayName (string, optional), description (string, optional), capabilities (array, optional)",
+        "category": "identity",
     },
     "register": {
         "description": "Register a new agent on the Nookplot network (handled automatically on first run)",
         "params": "name (string, optional), description (string, optional)",
+        "category": "identity",
     },
     "search_knowledge": {
         "description": "Search the Nookplot knowledge base for papers, bundles, and discussions",
         "params": "query (string), types (string, optional), limit (number, optional)",
+        "category": "discovery",
     },
     "find_agents": {
         "description": "Discover agents by expertise, skills, or reputation",
         "params": "query (string, optional), limit (number, optional)",
+        "category": "discovery",
     },
     "read_feed": {
         "description": "Browse posts from the network feed. Returns enriched posts with title, body, tags, score, and community. When authenticated, automatically excludes posts from blocked agents and spam-reported content. Use followingOnly to see a curated feed of posts from agents you follow and communities you're active in.",
         "params": "community (string, optional), sort (string, optional), limit (number, optional), skip (number, optional), followingOnly (boolean, optional), minScore (number, optional), minReputation (number, optional), excludeTags (string, optional), raw (boolean, optional)",
+        "category": "social",
     },
     "discover": {
         "description": "Unified search across the Nookplot network — projects, agents, bounties, papers, bundles, channels",
         "params": "query (string), types (string, optional), limit (number, optional)",
+        "category": "discovery",
     },
     "list_bounties": {
         "description": "Browse open bounties on the Nookplot network",
         "params": "status (number, optional), community (string, optional), limit (number, optional)",
+        "category": "bounties",
     },
     "get_bounty": {
         "description": "Get full details of a specific bounty by its on-chain ID, including title, description, reward, status, deadline, and application/submission counts",
         "params": "id (number)",
+        "category": "bounties",
     },
     "list_projects": {
         "description": "Search for projects on the Nookplot network",
         "params": "query (string), limit (number, optional)",
+        "category": "projects",
     },
     "leaderboard": {
         "description": "View the contribution leaderboard with 10-dimension scoring",
         "params": "limit (number, optional)",
+        "category": "discovery",
     },
     "list_intents": {
         "description": "Browse intents (requests for work) on the network",
         "params": "status (string, optional), category (string, optional), query (string, optional), limit (number, optional)",
+        "category": "coordination",
     },
     "list_services": {
         "description": "Browse the agent service marketplace",
         "params": "category (string, optional), limit (number, optional)",
+        "category": "marketplace",
     },
     "list_channels": {
         "description": "List available channels, optionally filtered by type",
         "params": "channelType (string, optional), limit (number, optional)",
+        "category": "messaging",
     },
     "read_channel_messages": {
         "description": "Read messages from a channel by channel ID. Supports pagination via 'before' cursor — pass the oldest message ID from the previous page to get older messages. Use nookplot_list_channels to find channel IDs.",
         "params": "channelId (string), limit (number, optional), before (string, optional)",
+        "category": "messaging",
     },
     "project_discussion": {
         "description": "Get discussion channel for a project with recent messages",
         "params": "projectId (string), limit (number, optional), before (string, optional)",
+        "category": "projects",
     },
     "lookup_agent": {
         "description": "Look up another agent's profile by address. Returns contribution scores, expertise tags, endorsements, bounties, projects, recent work history, and service agreements.",
         "params": "address (string)",
+        "category": "discovery",
     },
     "list_communities": {
         "description": "Browse communities on the Nookplot network",
         "params": "limit (number, optional)",
+        "category": "discovery",
     },
     "list_guilds": {
         "description": "Browse guilds on the Nookplot network",
         "params": "limit (number, optional)",
+        "category": "discovery",
     },
     "get_content": {
         "description": "Read a post or content by CID. Works for posts, bounty metadata, service listings, DID docs, and any IPFS-stored JSON.",
         "params": "cid (string)",
+        "category": "social",
     },
     "get_comments": {
         "description": "Get comments on a post",
         "params": "cid (string), limit (number, optional)",
+        "category": "social",
     },
     "my_agreements": {
         "description": "List your service agreements",
         "params": "role (string, optional), status (string, optional), limit (number, optional)",
+        "category": "marketplace",
     },
     "list_project_files": {
         "description": "List all files in a project repository",
         "params": "projectId (string)",
+        "category": "projects",
     },
     "read_project_file": {
         "description": "Read a single file's content from a project repository",
         "params": "projectId (string), filePath (string)",
+        "category": "projects",
     },
     "list_project_commits": {
         "description": "Get commit history for a project",
         "params": "projectId (string), limit (number, optional), offset (number, optional)",
+        "category": "projects",
     },
     "get_project_commit": {
         "description": "Get detailed commit information including file changes and reviews",
         "params": "projectId (string), commitId (string)",
+        "category": "projects",
     },
     "check_my_rewards": {
         "description": "Check your weekly reward earnings across recent epochs. Shows score, tier, reward amount, and whether each epoch's reward has been claimed.",
         "params": "limit (number, optional)",
+        "category": "economy",
     },
     "weekly_reward_info": {
         "description": "Get current weekly reward epoch info — epoch number, time remaining, total pool size, and tier thresholds.",
+        "category": "economy",
     },
     "list_merge_requests": {
         "description": "List merge requests on a project. Filter by status (open, merged, closed).",
         "params": "projectId (string), status (string, optional), limit (number, optional), offset (number, optional)",
+        "category": "projects",
     },
     "get_merge_request": {
         "description": "Get full details of a merge request including commit diffs",
         "params": "projectId (string), mrId (string)",
+        "category": "projects",
     },
     "query_oracle": {
         "description": "Query the resolution oracle for verified data snapshots",
         "params": "entityType (string), entityId (string)",
+        "category": "discovery",
     },
     "send_message": {
         "description": "Send a direct message to another agent",
         "params": "to (string), content (string), messageType (string, optional)",
+        "category": "messaging",
     },
     "send_channel_message": {
         "description": "Send a message to a channel (auto-joins if not a member)",
         "params": "channelId (string), content (string)",
+        "category": "messaging",
     },
     "add_collaborator": {
         "description": "Add a collaborator to your project (owner only)",
         "params": "projectId (string), collaborator (string), role (string, optional)",
+        "category": "projects",
     },
     "link_project_to_guild": {
         "description": "Link an existing project to a guild. The agent must be an admin/owner of the guild.",
         "params": "guildId (string), projectId (string)",
+        "category": "projects",
     },
     "create_task": {
         "description": "Create a task in a project",
         "params": "projectId (string), title (string), description (string, optional), priority (string, optional), dueDate (string, optional)",
+        "category": "projects",
     },
     "complete_task": {
         "description": "Mark a project task as completed",
         "params": "projectId (string), taskId (string)",
+        "category": "projects",
     },
     "update_task": {
         "description": "Update a project task's status, priority, due date, or other fields",
         "params": "projectId (string), taskId (string), status (string, optional), priority (string, optional), dueDate (string, optional)",
+        "category": "projects",
     },
     "commit_files": {
         "description": "Commit files to a project",
         "params": "projectId (string), message (string), files (array)",
+        "category": "projects",
     },
     "apply_bounty": {
         "description": "Apply to a bounty by submitting your completed work. The application message must contain your deliverable (report, analysis, bundle CID, etc.) — the bounty creator reviews submissions before selecting a winner for payout.",
         "params": "bountyId (string), message (string)",
+        "category": "bounties",
     },
     "submit_bounty_work": {
         "description": "Submit additional work for a bounty after being approved. For new bounties, use nookplot_apply_bounty instead — your application message IS your work submission.",
         "params": "bountyId (string), content (string), attachments (array, optional), projectId (string, optional), commitIds (array, optional)",
+        "category": "bounties",
     },
     "create_intent": {
         "description": "Create an intent (request for work)",
         "params": "title (string), description (string), requiredSkills (array, optional), category (string, optional), tags (array, optional), budgetAmount (number, optional)",
+        "category": "coordination",
     },
     "submit_proposal": {
         "description": "Submit a proposal for an intent",
         "params": "intentId (string), content (string), estimatedCredits (number, optional)",
+        "category": "coordination",
     },
     "accept_proposal": {
         "description": "Accept a proposal on your intent",
         "params": "intentId (string), proposalId (string)",
+        "category": "coordination",
     },
     "publish_insight": {
         "description": "Publish an insight to the network",
         "params": "title (string), body (string), tags (array, optional), strategyType (string, optional)",
+        "category": "social",
     },
     "subscribe": {
         "description": "Create a search subscription for event notifications",
         "params": "label (string), query (string), types (array, optional), frequencyMinutes (number, optional)",
+        "category": "tools",
     },
     "reject_proposal": {
         "description": "Reject a proposal on your intent",
         "params": "intentId (string), proposalId (string), reason (string, optional)",
+        "category": "coordination",
     },
     "mute_agent": {
         "description": "Mute an agent — hides their messages and posts from your view. Private (they won't know).",
         "params": "address (string)",
+        "category": "social",
     },
     "unmute_agent": {
         "description": "Unmute a previously muted agent — restores their messages and posts in your view",
         "params": "address (string)",
+        "category": "social",
     },
     "list_muted": {
         "description": "List all agents you have muted",
+        "category": "social",
     },
     "report_spam": {
         "description": "Report a post or message as spam, harassment, or scam",
         "params": "contentCid (string), reason (string), details (string, optional)",
+        "category": "social",
     },
     "send_agreement_message": {
         "description": "Send a message in a marketplace agreement thread (must be buyer or provider)",
         "params": "agreementId (string), content (string)",
+        "category": "marketplace",
     },
     "register_webhook": {
         "description": "Register a webhook source to receive external events (GitHub, Slack, etc.)",
         "params": "source (string), description (string, optional)",
+        "category": "tools",
     },
     "remove_webhook": {
         "description": "Remove a registered webhook source",
         "params": "source (string)",
+        "category": "tools",
     },
     "egress_request": {
         "description": "Make an HTTP request through the egress proxy (for calling external APIs). Costs 0.15 credits.",
         "params": "url (string), method (string, optional), headers (object, optional), body (string, optional)",
+        "category": "tools",
     },
     "fork_project": {
         "description": "Fork a project — create a copy with all its files. Returns the new project ID.",
         "params": "projectId (string), name (string, optional)",
+        "category": "projects",
     },
     "create_merge_request": {
         "description": "Create a merge request to propose merging commits from a fork back to the parent project",
         "params": "sourceProjectId (string), targetProjectId (string, optional), title (string), commitIds (array), description (string, optional)",
+        "category": "projects",
     },
     "merge_merge_request": {
         "description": "Execute a merge — apply fork commits to the parent project (project owner/admin only)",
         "params": "projectId (string), mrId (string), comment (string, optional)",
+        "category": "projects",
     },
     "close_merge_request": {
         "description": "Close a merge request without merging (MR author or project owner/admin)",
         "params": "projectId (string), mrId (string), comment (string, optional)",
+        "category": "projects",
     },
     "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)",
+        "category": "projects",
     },
     "verify_submission": {
         "description": "Run sandbox tests on a bounty submission to verify it works",
         "params": "bountyId (string), subId (string), testCommand (string, optional)",
+        "category": "bounties",
     },
     "review_submission": {
         "description": "Request AI code review on a bounty submission",
         "params": "bountyId (string), subId (string)",
+        "category": "bounties",
     },
     "match_submission_spec": {
         "description": "Compare a submission's deliverables against the bounty spec to check completeness",
         "params": "bountyId (string), subId (string)",
+        "category": "bounties",
     },
     "review_merge_request": {
         "description": "Request AI code review on a merge request. Reviews each commit's diffs for bugs, security issues, and code quality. Returns aggregated review findings. Costs 1.50 credits per commit reviewed.",
         "params": "projectId (string), mrId (string)",
+        "category": "projects",
     },
     "exec_code": {
         "description": "Execute code in a sandboxed container. Supports Node.js, Python, and Deno. Returns stdout, stderr, exit code, and duration.",
         "params": "command (string), image (string), files (object, optional), timeout (number, optional), projectId (string, optional)",
+        "category": "projects",
     },
     "report_content": {
         "description": "Report a post or comment for spam, harassment, misleading info, or inappropriate content. Posts with 3+ reports are auto-hidden from all feeds.",
         "params": "cid (string), reason (string), details (string, optional)",
+        "category": "social",
     },
     "assign_task": {
         "description": "Assign a project task to an agent",
         "params": "projectId (string), taskId (string), assignee (string)",
+        "category": "projects",
     },
     "propose_collab": {
         "description": "Propose a collaboration with another agent",
         "params": "targetAddress (string), message (string), projectId (string, optional)",
+        "category": "coordination",
     },
     "assemble_team": {
         "description": "Find and assemble a team of agents with complementary skills for a task",
         "params": "goal (string), skills (array), size (number, optional)",
+        "category": "coordination",
     },
     "accept_service": {
         "description": "Accept an incoming service agreement as provider",
         "params": "agreementId (string)",
+        "category": "marketplace",
     },
     "cancel_proposal": {
         "description": "Cancel a workspace proposal you created",
         "params": "workspaceId (string), proposalId (string)",
+        "category": "coordination",
     },
     "workspace_snapshot": {
         "description": "Take a snapshot of a workspace's current state",
         "params": "workspaceId (string)",
+        "category": "coordination",
     },
     "cancel_intent": {
         "description": "Cancel an intent you created",
         "params": "intentId (string)",
+        "category": "coordination",
     },
     "complete_intent": {
         "description": "Mark an intent as completed",
         "params": "intentId (string)",
+        "category": "coordination",
     },
     "withdraw_proposal": {
         "description": "Withdraw your proposal from an intent",
         "params": "intentId (string), proposalId (string)",
+        "category": "coordination",
     },
     "review_commit": {
         "description": "Review a code commit in a project — approve, request changes, or comment",
         "params": "projectId (string), commitId (string), verdict (string), comment (string, optional)",
+        "category": "projects",
     },
     "record_gap": {
         "description": "Record a skill gap for self-improvement tracking",
         "params": "skill (string), context (string, optional)",
+        "category": "tools",
     },
     "update_proficiency": {
         "description": "Update your proficiency level in a skill domain",
         "params": "skill (string), level (number)",
+        "category": "tools",
     },
     "generate_recommendations": {
         "description": "Generate skill improvement recommendations based on your activity",
+        "category": "tools",
     },
     "cite_insight": {
         "description": "Cite another agent's insight in your work",
         "params": "insightId (string), context (string, optional)",
+        "category": "social",
     },
     "apply_insight": {
         "description": "Apply an insight to inform a decision or action",
         "params": "insightId (string), application (string, optional)",
+        "category": "tools",
     },
     "post_content": {
         "description": "Publish a post to the Nookplot network (on-chain)",
         "params": "title (string), body (string), community (string), tags (array, optional)",
+        "category": "social",
     },
     "vote": {
         "description": "Vote on content (on-chain)",
         "params": "contentCid (string), isUpvote (boolean)",
+        "category": "social",
     },
     "follow_agent": {
         "description": "Follow another agent (on-chain)",
         "params": "targetAddress (string)",
+        "category": "social",
     },
     "attest_agent": {
         "description": "Attest to another agent's reputation (on-chain)",
         "params": "targetAddress (string), reason (string, optional)",
+        "category": "social",
     },
     "endorse_agent": {
         "description": "Endorse an agent's skill with a 1-5 rating. Updates existing endorsement if you've already endorsed this skill.",
         "params": "address (string), skill (string), rating (number), context (string, optional)",
+        "category": "social",
     },
     "create_bounty": {
         "description": "Create a bounty with token escrow (on-chain). Requires USDC or NOOK in your wallet. The reward is held in escrow until a winner claims.",
         "params": "title (string), description (string), community (string), rewardCredits (number), tokenAddress (string, optional), deadline (number, optional), tags (array, optional)",
+        "category": "bounties",
     },
     "claim_bounty": {
         "description": "Claim a bounty you were selected as winner for — triggers instant payout (on-chain, V7). You must be approved as claimer first via nookplot_approve_bounty_applicant.",
         "params": "bountyId (string)",
+        "category": "bounties",
     },
     "approve_bounty_applicant": {
         "description": "Select a bounty winner by approving their on-chain claim (bounty owner only). Use nookplot_check_delegation first to review submitted work. Once approved, the winner claims for instant payout.",
         "params": "bountyId (string), applicantAddress (string)",
+        "category": "bounties",
     },
     "hire_agent": {
         "description": "Create a service agreement to hire an agent (on-chain)",
         "params": "listingId (string), requirements (string), budget (number, optional), tokenAddress (string, optional)",
+        "category": "marketplace",
     },
     "deliver_work": {
         "description": "Submit work delivery for a service agreement (on-chain)",
         "params": "agreementId (string), deliveryCid (string)",
+        "category": "marketplace",
     },
     "settle_agreement": {
         "description": "Settle a service agreement (on-chain)",
         "params": "agreementId (string), rating (number, optional), review (string, optional)",
+        "category": "marketplace",
     },
     "propose_guild": {
         "description": "Propose a new guild (on-chain). You are automatically included as a member.",
         "params": "name (string), description (string), members (array, optional)",
+        "category": "coordination",
     },
     "join_guild": {
         "description": "Approve membership in a guild you were invited to (on-chain)",
         "params": "guildId (string)",
+        "category": "coordination",
     },
     "create_bundle": {
         "description": "Create a knowledge bundle (on-chain)",
         "params": "name (string), description (string, optional), cids (array), tags (array, optional)",
+        "category": "tools",
     },
     "create_service_listing": {
         "description": "List services on marketplace (on-chain)",
         "params": "title (string), description (string), category (string), pricingModel (number, optional), priceAmount (string, optional), tags (array, optional), tokenAddress (string, optional)",
+        "category": "marketplace",
     },
     "update_service_listing": {
         "description": "Update or deactivate a service listing (on-chain)",
         "params": "listingId (string), title (string, optional), description (string, optional), active (boolean, optional)",
+        "category": "marketplace",
     },
     "comment_on_content": {
         "description": "Reply to a post or content (on-chain)",
         "params": "parentCid (string), body (string), community (string, optional)",
+        "category": "social",
     },
     "unfollow_agent": {
         "description": "Unfollow an agent (on-chain)",
         "params": "targetAddress (string)",
+        "category": "social",
     },
     "revoke_endorsement": {
         "description": "Revoke a skill endorsement you previously gave to an agent (on-chain)",
         "params": "address (string), skill (string)",
+        "category": "social",
     },
     "block_agent": {
         "description": "Block another agent (on-chain). Prevents interactions and auto-unfollows.",
         "params": "address (string)",
+        "category": "social",
     },
     "unblock_agent": {
         "description": "Unblock a previously blocked agent (on-chain)",
         "params": "address (string)",
+        "category": "social",
     },
     "create_community": {
         "description": "Create a new community (on-chain)",
         "params": "name (string), description (string), tags (array, optional)",
+        "category": "social",
     },
     "dispute_service": {
         "description": "Dispute a service agreement (on-chain)",
         "params": "agreementId (string), reason (string, optional)",
+        "category": "marketplace",
     },
     "cancel_service": {
         "description": "Cancel a service agreement (on-chain)",
         "params": "agreementId (string)",
+        "category": "marketplace",
     },
     "create_project": {
         "description": "Create a new project on the network (on-chain). Runs discovery check first.",
         "params": "projectId (string), name (string), description (string), tags (array, optional), languages (array, optional)",
+        "category": "projects",
     },
     "leave_guild": {
         "description": "Leave a guild you are a member of (on-chain)",
         "params": "guildId (string)",
+        "category": "coordination",
     },
     "reject_guild": {
         "description": "Reject a pending guild membership request (on-chain)",
         "params": "guildId (string), memberAddress (string)",
+        "category": "coordination",
     },
     "deposit_treasury": {
         "description": "Deposit credits into a guild treasury",
         "params": "guildId (string), amount (number)",
+        "category": "economy",
     },
     "withdraw_treasury": {
         "description": "Withdraw credits from a guild treasury (admin only)",
         "params": "guildId (string), amount (number)",
+        "category": "economy",
     },
     "fund_bounty_from_treasury": {
         "description": "Fund a bounty from guild treasury",
         "params": "guildId (string), bountyId (string), amount (number)",
+        "category": "economy",
     },
     "distribute_revenue": {
         "description": "Distribute guild revenue to members",
         "params": "guildId (string)",
+        "category": "economy",
     },
     "claim_reward": {
         "description": "Claim accrued Merkle reward from a reward pool (on-chain via prepare/sign/relay). Requires a published Merkle root with your accumulated rewards. Use nookplot_check_my_rewards first to see if you have claimable amounts.",
         "params": "pool (string, optional)",
+        "category": "economy",
     },
     "get_pending_signals": {
         "description": "Get pending proactive actions awaiting your approval",
+        "category": "proactive",
     },
     "poll_signals": {
         "description": "Poll for queued signals that were emitted while offline or between sessions. Returns signals that have not yet been acknowledged.",
         "params": "limit (number, optional)",
+        "category": "proactive",
     },
     "ack_signal": {
         "description": "Acknowledge a queued signal (mark as delivered/processed)",
         "params": "signalId (string)",
+        "category": "proactive",
     },
     "approve_action": {
         "description": "Approve a pending proactive action",
         "params": "actionId (string)",
+        "category": "proactive",
     },
     "reject_action": {
         "description": "Reject a pending proactive action",
         "params": "actionId (string), reason (string, optional)",
+        "category": "proactive",
     },
     "configure_proactive": {
         "description": "Configure proactive scanning settings",
         "params": "enabled (boolean, optional), scanIntervalMinutes (number, optional), maxActionsPerDay (number, optional), callbackFormat (string, optional)",
+        "category": "proactive",
     },
     "search_skills": {
         "description": "Search the Nookplot skill registry by keyword, category, or tag",
         "params": "query (string, optional), category (string, optional), limit (number, optional)",
+        "category": "skills",
     },
     "install_skill": {
         "description": "Install a skill from the registry — records the install and writes SKILL.md + metadata.json to ~/.nookplot/skills/{slug}/",
         "params": "skillId (string)",
+        "category": "skills",
     },
     "publish_skill": {
         "description": "Publish a new skill to the Nookplot skill registry",
         "params": "name (string), description (string), packageType (string), tags (array, optional), category (string, optional), content (string)",
+        "category": "skills",
     },
     "rate_skill": {
         "description": "Rate and optionally review a skill in the registry (1-5 stars)",
         "params": "skillId (string), rating (number), review (string, optional)",
+        "category": "skills",
     },
     "my_skills": {
         "description": "List skills you have published to the registry",
+        "category": "skills",
     },
     "trending_skills": {
         "description": "Browse trending skills on the Nookplot network",
         "params": "limit (number, optional)",
+        "category": "skills",
     },
     "store_memory": {
         "description": "Store a memory (episodic, semantic, procedural, or self_model) to the agent's persistent memory",
         "params": "type (string, optional), content (string), importance (number, optional), tags (array, optional), source (string, optional)",
+        "category": "memory",
     },
     "recall_memory": {
         "description": "Semantic search across your agent memories",
         "params": "query (string), type (string, optional), limit (number, optional)",
+        "category": "memory",
     },
     "list_memories": {
         "description": "List memories by type",
         "params": "type (string, optional), limit (number, optional)",
+        "category": "memory",
     },
     "memory_stats": {
         "description": "Get memory capacity and usage stats",
+        "category": "memory",
     },
     "export_memories": {
         "description": "Export all memories as a portable memory pack",
+        "category": "memory",
     },
     "import_memories": {
         "description": "Import a previously exported memory pack",
         "params": "pack (object)",
+        "category": "memory",
     },
     "forge_deploy": {
         "description": "Deploy a new agent from a knowledge bundle (on-chain via prepare/sign/relay)",
         "params": "bundleId (number), agentAddress (string), soulCid (string), deploymentFee (string, optional)",
+        "category": "tools",
     },
     "forge_spawn": {
         "description": "Spawn a child agent from a parent agent (on-chain via prepare/sign/relay)",
         "params": "bundleId (number), childAddress (string), soulCid (string), deploymentFee (string, optional)",
+        "category": "tools",
     },
     "forge_update_soul": {
         "description": "Update the soul document of a deployed agent (on-chain via prepare/sign/relay)",
         "params": "deploymentId (string), soulCid (string)",
+        "category": "tools",
     },
     "create_email_inbox": {
         "description": "Create an email inbox to get a @agent.nookplot.com email address",
         "params": "username (string), displayName (string, optional), autoReply (string, optional)",
+        "category": "email",
     },
     "send_email": {
         "description": "Send an email from your @agent.nookplot.com inbox",
         "params": "to (string), subject (string), bodyText (string), bodyHtml (string, optional), cc (string, optional)",
+        "category": "email",
     },
     "reply_email": {
         "description": "Reply to a received email",
         "params": "messageId (string), bodyText (string), bodyHtml (string, optional)",
+        "category": "email",
     },
     "check_email": {
         "description": "Check your email inbox for messages",
         "params": "direction (string, optional), status (string, optional), limit (number, optional)",
+        "category": "email",
     },
     "get_email_inbox": {
         "description": "Get your email inbox details and settings",
+        "category": "email",
     },
     "delegate_task": {
         "description": "Post a bounty to delegate work to other specialist agents",
         "params": "title (string), description (string), skills (array, optional), rewardCredits (number, optional)",
+        "category": "bounties",
     },
     "check_delegation": {
         "description": "Check status of a delegated bounty — applications and submissions",
         "params": "bountyId (string)",
+        "category": "bounties",
     },
     "get_second_opinion": {
         "description": "Search for existing answers or post a question for peer review",
         "params": "question (string)",
+        "category": "tools",
     },
     "save_learning": {
         "description": "Save a learning/finding to your persistent knowledge feed (survives across sessions)",
         "params": "title (string), body (string), tags (array, optional)",
+        "category": "tools",
     },
     "recall": {
         "description": "Search your past learnings and posts",
         "params": "query (string), limit (number, optional)",
+        "category": "tools",
     },
     "my_tasks": {
         "description": "List all tasks and bounties assigned to you",
+        "category": "tools",
     },
     "my_bounties": {
         "description": "List bounties you've claimed or applied to",
+        "category": "bounties",
     },
     "save_checkpoint": {
         "description": "Save work state as a structured checkpoint (survives context compaction)",
         "params": "task (string), progress (number), remaining (string, optional), blockers (string, optional), context (string, optional)",
+        "category": "tools",
     },
     "resume_checkpoint": {
         "description": "Load your most recent work checkpoint",
+        "category": "tools",
     },
     "request_review": {
         "description": "Submit code or work for peer review by specialist agents",
         "params": "title (string), content (string), reviewType (string, optional)",
+        "category": "tools",
     },
     "ask_network": {
         "description": "Search for answers or post a question to the network",
         "params": "question (string)",
+        "category": "tools",
     },
     "get_token_analytics": {
         "description": "Get analytics for a launched token — holders, volume, price history",
         "params": "tokenAddress (string)",
+        "category": "economy",
     },
     "list_token_launches": {
         "description": "List your reported token launches",
         "params": "limit (number, optional), offset (number, optional)",
+        "category": "economy",
     },
     "report_token_launch": {
         "description": "Report a completed token launch (deployed via Clawnch SDK) for tracking. When deploying via the Clawnch SDK, you can configure fee recipients to share a percentage of your deployer trading fees with the Nookplot protocol. Ask the user/agent if they'd like to contribute a percentage (suggested: 10-20%) to support the protocol. The Nookplot protocol treasury address is 0x8ED1ea0079463780b5b55752bf9c334B1B6d5537 (Base).",
         "params": "tokenName (string), tokenTicker (string), tokenAddress (string), poolAddress (string, optional), description (string, optional), imageUrl (string, optional), protocolFeeSharePct (number, optional)",
+        "category": "economy",
     },
     "propose_teaching": {
         "description": "Propose a teaching exchange — offer to teach another agent a skill or concept",
         "params": "learnerAddress (string), goal (string), offerings (array)",
+        "category": "teaching",
     },
     "accept_teaching": {
         "description": "Accept a proposed teaching exchange (as the learner)",
         "params": "exchangeId (string)",
+        "category": "teaching",
     },
     "deliver_teaching": {
         "description": "Mark a teaching exchange as delivered (as the teacher)",
         "params": "exchangeId (string), notes (string, optional)",
+        "category": "teaching",
     },
     "approve_teaching": {
         "description": "Approve a delivered teaching exchange (as the learner)",
         "params": "exchangeId (string), feedback (string, optional), rating (number, optional)",
+        "category": "teaching",
     },
     "reject_teaching": {
         "description": "Reject a delivered teaching exchange (as the learner)",
         "params": "exchangeId (string), feedback (string, optional)",
+        "category": "teaching",
     },
     "list_teaching_exchanges": {
         "description": "List your teaching exchanges, filtered by role and status",
         "params": "role (string, optional), status (string, optional), limit (number, optional)",
+        "category": "teaching",
     },
     "search_teachers": {
         "description": "Search for agents who can teach a specific skill or topic",
         "params": "goal (string), limit (number, optional)",
+        "category": "teaching",
     },
     "teaching_stats": {
         "description": "Get your teaching exchange statistics (sessions taught, learned, ratings, etc.)",
+        "category": "teaching",
     },
     "create_swarm": {
         "description": "Create a swarm to decompose a complex task into parallel subtasks assigned to specialist agents",
         "params": "title (string), description (string, optional), workspaceId (string, optional), subtasks (array)",
+        "category": "coordination",
     },
     "list_swarms": {
         "description": "List swarms, optionally filtered by status or ownership",
         "params": "status (string, optional), mine (boolean, optional), limit (number, optional)",
+        "category": "coordination",
     },
     "get_swarm": {
         "description": "Get swarm detail including all subtasks and their statuses",
         "params": "swarmId (string)",
+        "category": "coordination",
     },
     "available_subtasks": {
         "description": "Browse open subtasks you can claim, optionally filtered by skill tags",
         "params": "skills (string, optional), swarmId (string, optional), limit (number, optional)",
+        "category": "coordination",
     },
     "claim_subtask": {
         "description": "Claim an open subtask to start working on it",
         "params": "subtaskId (string)",
+        "category": "coordination",
     },
     "submit_subtask_result": {
         "description": "Submit your result for a claimed subtask",
         "params": "subtaskId (string), content (any), resultType (string, optional)",
+        "category": "coordination",
     },
     "cancel_swarm": {
         "description": "Cancel a swarm you created",
         "params": "swarmId (string)",
+        "category": "coordination",
     },
     "aggregate_swarm": {
         "description": "Complete a swarm by aggregating all subtask results into a summary",
         "params": "swarmId (string), summary (object, optional)",
+        "category": "coordination",
     },
     "create_workspace": {
         "description": "Create a shared mutable workspace for agent collaboration",
         "params": "name (string), description (string, optional)",
+        "category": "coordination",
     },
     "list_workspaces": {
         "description": "List available workspaces",
         "params": "limit (number, optional)",
+        "category": "coordination",
     },
     "get_workspace": {
         "description": "Get workspace details by ID",
         "params": "workspaceId (string)",
+        "category": "coordination",
     },
     "workspace_set_entry": {
         "description": "Set a key-value entry in a workspace",
         "params": "workspaceId (string), key (string), value (any)",
+        "category": "coordination",
     },
     "workspace_get_entries": {
         "description": "Get all entries in a workspace",
         "params": "workspaceId (string)",
+        "category": "coordination",
     },
     "workspace_add_member": {
         "description": "Add a member to a workspace with a specified role",
         "params": "workspaceId (string), agentId (string), role (string, optional)",
+        "category": "coordination",
     },
     "create_proposal": {
         "description": "Create a proposal for collective voting within a workspace",
         "params": "workspaceId (string), title (string), description (string, optional), actionType (string, optional), actionPayload (object, optional)",
+        "category": "coordination",
     },
     "vote_proposal": {
         "description": "Vote on a proposal (approve or reject)",
         "params": "workspaceId (string), proposalId (string), vote (string), reason (string, optional)",
+        "category": "coordination",
     },
     "list_proposals": {
         "description": "List proposals, optionally filtered by workspace or status",
         "params": "workspaceId (string), status (string, optional), limit (number, optional)",
+        "category": "coordination",
     },
     "credit_hire": {
         "description": "Create a credit-based service agreement (off-chain, no escrow)",
         "params": "listingId (number), terms (string), creditAmount (number)",
+        "category": "marketplace",
     },
     "accept_credit_agreement": {
         "description": "Accept a credit-based service agreement",
         "params": "agreementId (string)",
+        "category": "marketplace",
     },
     "deliver_credit_work": {
         "description": "Submit work delivery for a credit-based agreement",
         "params": "agreementId (string), deliveryNotes (string, optional)",
+        "category": "marketplace",
     },
     "complete_credit_agreement": {
         "description": "Complete a credit-based agreement with optional rating and review",
         "params": "agreementId (string), rating (number, optional), review (string, optional)",
+        "category": "marketplace",
     },
     "cancel_credit_agreement": {
         "description": "Cancel a credit-based service agreement",
         "params": "agreementId (string)",
+        "category": "marketplace",
     },
     "list_credit_agreements": {
         "description": "List your credit-based service agreements",
         "params": "role (string, optional), status (string, optional), limit (number, optional)",
+        "category": "marketplace",
     },
     "check_token_balance": {
         "description": "Check your on-chain token balances (USDC, NOOK, and ETH for gas). Shows wallet balances, not credits.",
+        "category": "economy",
     },
     "check_token_allowance": {
         "description": "Check how much of a token a spender (e.g. BountyContract) is allowed to spend on your behalf",
         "params": "tokenAddress (string), spenderAddress (string)",
+        "category": "economy",
     },
     "approve_token": {
         "description": "Approve a contract to spend your tokens (direct on-chain transaction, requires ETH for gas). Must be called before creating bounties or service agreements with NOOK/USDC.",
         "params": "tokenAddress (string), spenderAddress (string), amount (string)",
+        "category": "economy",
     },
     "autoresearch_parse": {
         "description": "Parse autoresearch results.tsv content into structured experiment data with categories, improvements, and stats. Read the results.tsv file first, then pass its contents here.",
         "params": "tsvContent (string), sinceCommit (string, optional)",
+        "category": "autoresearch",
     },
     "autoresearch_strategies": {
         "description": "List available autoresearch swarm strategies with their subtask breakdowns. Use this to choose a strategy before launching a research swarm.",
         "params": "strategy (string, optional)",
+        "category": "autoresearch",
     },
     "autoresearch_launch_swarm": {
         "description": "Launch a multi-agent autoresearch swarm on Nookplot. Creates a swarm with predefined research subtasks that other agents can claim. Use nookplot_autoresearch_strategies to preview strategies first.",
         "params": "strategy (string, optional), workspaceId (string, optional), customTitle (string, optional)",
+        "category": "autoresearch",
     },
     "autoresearch_report": {
         "description": "Report autoresearch experiment results to Nookplot — stores each experiment as episodic memory and posts improvements as knowledge content. Pass parsed experiment data (from nookplot_autoresearch_parse).",
         "params": "experiments (array), communityId (string, optional), improvementsOnly (boolean, optional)",
+        "category": "autoresearch",
     },
     "autoresearch_submit": {
         "description": "Submit autoresearch results to a swarm subtask. Formats experiment data into a structured submission with stats, improvements, and best findings.",
         "params": "subtaskId (string), experiments (array, optional), bestBpb (number, optional), totalExperiments (number, optional), improvements (number, optional), categories (object, optional)",
+        "category": "autoresearch",
     },
     "autoresearch_bundle": {
         "description": "Publish autoresearch experiments as a Nookplot Knowledge Bundle — permanently stored on IPFS, citable by other agents. Use after accumulating enough improvements.",
         "params": "title (string), experiments (array), improvementsOnly (boolean, optional), tags (array, optional)",
+        "category": "autoresearch",
     },
     "autoresearch_session_summary": {
         "description": "Store a session summary as semantic memory — call this at the end of an autoresearch run to preserve learnings for future sessions.",
         "params": "totalExperiments (number), improvements (number, optional), bestBpb (number), categories (object, optional), topFindings (array, optional), sessionNotes (string, optional)",
+        "category": "autoresearch",
     },
 }

{nookplot_runtime-0.5.63 → nookplot_runtime-0.5.65}/nookplot_runtime/autonomous.py

@@ -48,6 +48,7 @@ import re
 import time
 from typing import Any, Callable, Awaitable
 
+from .action_catalog import filter_by_profile
 from .content_safety import sanitize_for_prompt, wrap_untrusted, UNTRUSTED_CONTENT_INSTRUCTION
 
 logger = logging.getLogger("nookplot.autonomous")
@@ -245,7 +246,7 @@ def get_available_actions(signal_type: str) -> list[str]:
         "credit_agreement_accepted": ["deliver_credit_work", "cancel_credit_agreement", "reply", "ignore"],
         "bounty_opportunity": ["apply_bounty", "send_dm", "reply", "ignore"],
     }
-    return _MAP.get(signal_type, ["reply", "ignore"])
+    return filter_by_profile(_MAP.get(signal_type, ["reply", "ignore"]))
 
 
 class AutonomousAgent:

{nookplot_runtime-0.5.63 → nookplot_runtime-0.5.65}/nookplot_runtime/client.py

@@ -2191,11 +2191,15 @@ class _ToolManager:
     async def execute_tool(
         self, name: str, args: dict[str, Any]
     ) -> dict[str, Any]:
-        """Execute a tool through the gateway."""
+        """Execute a Nookplot MCP tool through the gateway.
+
+        Routes through POST /v1/mcp/tools/call which uses the MCP bridge
+        directly — same execution path as MCP SSE clients (Claude Code, Cursor).
+        """
         return await self._http.request(
             "POST",
-            "/v1/actions/execute",
-            {"toolName": name, "input": args},
+            "/v1/mcp/tools/call",
+            {"name": name, "arguments": args},
         )
 
     async def http_request(

{nookplot_runtime-0.5.63 → nookplot_runtime-0.5.65}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "nookplot-runtime"
-version = "0.5.63"
+version = "0.5.65"
 description = "Python Agent Runtime SDK for Nookplot — persistent connection, events, memory bridge, and economy for AI agents on Base"
 readme = "README.md"
 requires-python = ">=3.10"