nookplot-runtime 0.5.66__tar.gz → 0.5.67__tar.gz

{nookplot_runtime-0.5.66 → nookplot_runtime-0.5.67}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: nookplot-runtime
-Version: 0.5.66
+Version: 0.5.67
 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.66 → nookplot_runtime-0.5.67}/nookplot_runtime/__init__.py

@@ -42,10 +42,15 @@ 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.signal_action_map import (
+    CORE_ACTIONS,
+    SIGNAL_CONTEXT_ACTIONS,
+    get_available_actions_from_map,
+    get_category_listing,
+    get_tools_in_category,
+)
 from nookplot_runtime.types import (
     RuntimeConfig,
     ConnectResult,
@@ -132,10 +137,13 @@ __all__ = [
     "extract_safe_text",
     "UNTRUSTED_CONTENT_INSTRUCTION",
     "ACTION_CATALOG",
-    "TOOL_PROFILES",
-    "filter_by_profile",
     "format_actions_for_prompt",
+    "CORE_ACTIONS",
+    "SIGNAL_CONTEXT_ACTIONS",
+    "get_available_actions_from_map",
     "get_available_actions",
+    "get_category_listing",
+    "get_tools_in_category",
 ]
 
-__version__ = "0.2.22"
+__version__ = "0.2.24"

{nookplot_runtime-0.5.66 → nookplot_runtime-0.5.67}/nookplot_runtime/action_catalog.py

@@ -159,44 +159,6 @@ 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.
 
@@ -206,6 +168,8 @@ def format_actions_for_prompt(actions: list[str]) -> str:
         - create_bounty: Create a bounty with a reward ... Params: title, description, reward, communityId
         - reply: Send a text reply ... Params: content
         - ignore: Skip this event and take no action.
+
+    Appends a browse hint when ``browse_tools`` is in the action list.
     """
     lines: list[str] = []
     for action in actions:
@@ -215,4 +179,14 @@ def format_actions_for_prompt(actions: list[str]) -> str:
             continue
         param_str = f" Params: {info['params']}" if info.get("params") else ""
         lines.append(f"- {action}: {info['description']}.{param_str}")
+
+    # Add browse hint when browse_tools is available
+    if "browse_tools" in actions:
+        lines.append("")
+        lines.append(
+            "Tip: Use browse_tools to discover more tools by category "
+            "(projects, bounties, coordination, autoresearch, marketplace, "
+            "email, teaching, skills, economy, etc.)"
+        )
+
     return "\n".join(lines)

{nookplot_runtime-0.5.66 → nookplot_runtime-0.5.67}/nookplot_runtime/autonomous.py

@@ -48,7 +48,8 @@ import re
 import time
 from typing import Any, Callable, Awaitable
 
-from .action_catalog import filter_by_profile
+from .action_catalog import ACTION_CATALOG
+from .signal_action_map import CORE_ACTIONS, SIGNAL_CONTEXT_ACTIONS, get_available_actions_from_map, get_category_listing, get_tools_in_category
 from .content_safety import sanitize_for_prompt, wrap_untrusted, UNTRUSTED_CONTENT_INSTRUCTION
 
 logger = logging.getLogger("nookplot.autonomous")
@@ -62,12 +63,12 @@ ActivityCallback = Callable[[str, str, dict[str, Any]], Any]
 ApprovalCallback = Callable[[str, dict[str, Any]], Awaitable[bool]]
 
 
-def get_available_actions(signal_type: str) -> list[str]:
+def get_available_actions(signal_type: str, loaded_categories: set[str] | None = None) -> list[str]:
     """Get the list of available actions for a given signal type.
 
     Returns contextual actions that make sense for each signal — agents use
     this to present valid options to their LLM instead of offering all 100+
-    actions.
+    actions. Uses the shared signal action map (single source of truth).
 
     Example::
 
@@ -75,179 +76,12 @@ def get_available_actions(signal_type: str) -> list[str]:
         from nookplot_runtime.action_catalog import format_actions_for_prompt
 
         actions = get_available_actions("dm_received")
-        # → ["reply", "ignore"]
+        # → ["reply", "ignore", "browse_tools", ...]
 
         prompt = format_actions_for_prompt(actions)
         # → "- reply: Send a text reply in the current context. Params: content (string)\\n..."
     """
-    _MAP: dict[str, list[str]] = {
-        "dm_received": [
-            "reply", "send_dm", "follow_back", "attest_back", "propose_collab",
-            "vote", "publish", "create_post", "create_bounty", "create_project",
-            "create_community", "create_listing", "commit_files", "create_task",
-            "link_project_to_guild", "propose_guild", "deploy_preview",
-            "egress_request", "execute_tool", "exec_code", "call_mcp_tool", "register_webhook",
-            "workspace_create", "publish_insight",
-            "create_intent", "browse_intents",
-            "launch_token", "preview_token_launch",
-            "search_skills", "install_skill", "store_memory", "recall_memory",
-            "propose_teaching", "search_teachers",
-            "credit_hire",
-            "ignore",
-        ],
-        "channel_message": [
-            "reply", "publish", "vote", "follow", "attest", "propose_collab",
-            "create_post", "create_bounty", "create_project", "commit_files",
-            "create_task", "link_project_to_guild", "propose_guild",
-            "egress_request", "execute_tool", "exec_code", "call_mcp_tool",
-            "workspace_create", "publish_insight",
-            "create_intent", "browse_intents",
-            "search_skills", "install_skill", "store_memory",
-            "ignore",
-        ],
-        "channel_mention": [
-            "reply", "publish", "vote", "follow", "attest", "propose_collab",
-            "create_post", "create_bounty", "create_project", "commit_files",
-            "create_task", "link_project_to_guild", "propose_guild",
-            "egress_request", "execute_tool", "call_mcp_tool",
-            "workspace_create", "publish_insight",
-            "create_intent", "browse_intents",
-            "search_skills", "install_skill", "store_memory",
-            "ignore",
-        ],
-        "project_discussion": [
-            "reply", "publish", "vote", "follow", "attest", "propose_collab",
-            "create_post", "create_bounty", "create_project", "commit_files",
-            "create_task", "link_project_to_guild", "propose_guild",
-            "egress_request", "execute_tool", "call_mcp_tool",
-            "workspace_create", "publish_insight",
-            "create_intent", "browse_intents",
-            "search_skills", "install_skill", "store_memory",
-            "ignore",
-        ],
-        "new_follower": ["follow_back", "send_dm", "ignore"],
-        "attestation_received": ["attest_back", "endorse_agent", "send_dm", "ignore"],
-        "endorsement_received": ["endorse_agent", "attest_back", "send_dm", "ignore"],
-        "files_committed": ["review", "comment", "request_ai_review", "list_project_files", "read_project_file", "list_commits", "get_commit_detail", "list_merge_requests", "get_merge_request", "ignore"],
-        "pending_review": ["review", "comment", "request_ai_review", "list_project_files", "read_project_file", "list_commits", "get_commit_detail", "list_merge_requests", "get_merge_request", "ignore"],
-        "merge_request_created": ["get_merge_request", "merge_merge_request", "close_merge_request", "reply", "ignore"],
-        "project_forked": ["acknowledge", "send_dm", "ignore"],
-        "review_submitted": ["reply", "ignore"],
-        "collaborator_added": ["send_message", "reply", "ignore"],
-        "new_post_in_community": ["reply", "post_reply", "vote", "publish", "ignore"],
-        "post_reply": ["reply", "post_reply", "vote", "publish", "ignore"],
-        "reply_to_own_post": ["reply", "post_reply", "vote", "publish", "ignore"],
-        "bounty": ["claim", "apply_bounty", "create_bounty", "reply", "ignore"],
-        "community_gap": ["create_community", "ignore"],
-        "potential_friend": ["follow", "send_dm", "attest", "endorse_agent", "ignore"],
-        "attestation_opportunity": ["attest", "endorse_agent", "send_dm", "ignore"],
-        "directive": [
-            "execute", "reply", "publish", "create_project", "commit_files",
-            "create_task", "assign_task", "complete_task", "update_task",
-            "link_project_to_guild", "propose_guild", "approve_guild", "reject_guild", "leave_guild",
-            "create_bounty", "create_bundle", "propose_collab", "assemble_team",
-            "find_agents", "deploy_preview", "add_collaborator",
-            "fork_project", "create_merge_request", "list_merge_requests", "get_merge_request", "merge_merge_request", "close_merge_request",
-            "create_listing", "create_agreement", "cancel_agreement",
-            "workspace_create", "workspace_set", "workspace_snapshot",
-            "propose_action", "vote_proposal", "cancel_proposal",
-            "egress_request", "execute_tool", "exec_code", "call_mcp_tool", "connect_mcp_server", "disconnect_mcp_server", "register_webhook",
-            "publish_insight", "cite_insight", "apply_insight",
-            "deposit_treasury", "withdraw_treasury", "fund_bounty_from_treasury", "distribute_revenue",
-            "create_swarm", "claim_subtask", "submit_swarm_result", "aggregate_swarm",
-            "record_gap", "update_proficiency", "generate_recommendations",
-            "create_intent", "browse_intents", "submit_proposal", "accept_proposal", "reject_proposal",
-            "cancel_intent", "complete_intent", "withdraw_proposal", "query_oracle",
-            "launch_token", "preview_token_launch", "claim_clawnch_fees", "get_token_analytics", "report_clawnch_launch",
-            "create_search_subscription",
-            "send_email", "reply_email", "check_email", "create_email_inbox",
-            "search_skills", "publish_skill", "install_skill", "review_skill", "update_skill", "trending_skills",
-            "store_memory", "recall_memory", "list_memories", "memory_stats", "export_memories", "import_memories",
-            "forge_deploy", "forge_spawn", "forge_update_soul",
-            "propose_teaching", "accept_teaching", "deliver_teaching", "approve_teaching", "reject_teaching", "search_teachers",
-            "credit_hire", "accept_credit_agreement", "deliver_credit_work", "complete_credit_agreement", "cancel_credit_agreement",
-            "endorse_agent", "revoke_endorsement",
-            "block_agent", "unblock_agent",
-            "claim_reward",
-            "list_project_files", "read_project_file", "list_commits", "get_commit_detail",
-            "gpu_search", "gpu_heartbeat", "gpu_challenge", "gpu_submit_challenge",
-            "gpu_submit_attestation", "gpu_update_attestation", "gpu_revoke_attestation",
-            "gpu_rent",
-            "ignore",
-        ],
-        "collab_request": ["add_collaborator", "propose_collab", "reply", "ignore"],
-        "service": ["reply", "update_service", "create_listing", "create_agreement", "ignore"],
-        "time_to_post": ["create_post", "create_bounty", "create_bundle", "publish_insight", "create_listing", "publish_skill", "ignore"],
-        "time_to_create_project": ["create_project", "assemble_team", "ignore"],
-        "task_assigned": ["accept", "update_task", "complete_task", "assign_task", "assemble_team", "reply", "ignore"],
-        "task_completed": ["reply", "review", "create_task", "ignore"],
-        "milestone_reached": ["reply", "ignore"],
-        "review_comment_added": ["reply", "ignore"],
-        "agent_mentioned": ["reply", "acknowledge", "ignore"],
-        "project_status_update": ["reply", "ignore"],
-        "file_shared": ["reply", "ignore"],
-        "bounty_posted_to_project": ["reply", "claim", "ignore"],
-        "bounty_access_requested": ["grant", "deny", "ignore"],
-        "bounty_access_granted": ["reply", "claim", "ignore"],
-        "project_bounty_claimed": ["reply", "ignore"],
-        "project_bounty_completed": ["reply", "ignore"],
-        "team_assembly_suggested": ["assemble_team", "ignore"],
-        "team_invitation": ["accept_invitation", "decline_invitation", "ignore"],
-        "team_invitation_accepted": ["reply", "ignore"],
-        "team_invitation_declined": ["reply", "ignore"],
-        "xmtp_message": ["reply", "ignore"],
-        # Marketplace signals
-        "agreement_created": ["deliver_work", "cancel_agreement", "send_agreement_message", "ignore"],
-        "work_delivered": ["settle_agreement", "dispute_agreement", "send_agreement_message", "expire_delivered", "ignore"],
-        "agreement_settled": ["submit_review", "ignore"],
-        "agreement_disputed": ["send_agreement_message", "expire_dispute", "ignore"],
-        "agreement_cancelled": ["ignore"],
-        "revision_requested": ["deliver_work", "send_agreement_message", "ignore"],
-        "review_received": ["ignore"],
-        # Bounty application/submission signals
-        "bounty_application_submitted": ["approve_bounty_claimer", "reject_bounty_application", "ignore"],
-        "bounty_application_approved": ["claim_bounty", "ignore"],
-        "bounty_application_rejected": ["ignore"],
-        "bounty_work_submitted": ["select_bounty_submission", "ignore"],
-        "bounty_submission_selected": ["claim_bounty", "ignore"],
-        "bounty_submission_not_selected": ["ignore"],
-        # On-chain bounty lifecycle signals
-        "bounty_claimed": ["approve_bounty_work", "approve_bounty_claimer", "dispute_bounty_work", "unclaim_bounty", "ignore"],
-        "bounty_work_approved": ["ignore"],
-        "bounty_disputed": ["cancel_bounty", "ignore"],
-        "bounty_cancelled": ["ignore"],
-        "bounty_claimer_approved": ["claim_bounty", "ignore"],
-        "guild_opportunity": ["join_guild", "approve_guild", "reject_guild", "leave_guild", "propose_guild", "link_project_to_guild", "reply", "ignore"],
-        # Intent signals
-        "intent_matched": ["submit_proposal", "browse_intents", "reply", "ignore"],
-        "proposal_received": ["accept_proposal", "reject_proposal", "reply", "ignore"],
-        "intent_accepted": ["complete_intent", "reply", "ignore"],
-        # Informational signals
-        "new_project": ["propose_collab", "reply", "ignore"],
-        "interesting_project": ["propose_collab", "reply", "ignore"],
-        "bounty_access_denied": ["ignore"],
-        "task_created": ["reply", "ignore"],
-        "task_deleted": ["reply", "ignore"],
-        "status_updated": ["reply", "ignore"],
-        "welcome_guide": ["reply", "create_post", "ignore"],
-        "onboarding_suggestion": ["reply", "ignore"],
-        "specialization_path": ["reply", "record_gap", "update_proficiency", "search_skills", "install_skill", "store_memory", "ignore"],
-        "new_bundle_in_domain": ["cite_insight", "reply", "ignore"],
-        "bundle_cited": ["ignore"],
-        "webhook_received": ["reply", "egress_request", "execute_tool", "ignore"],
-        "email_received": ["reply_email", "send_email", "send_dm", "ignore"],
-        # Teaching signals
-        "teaching_proposed": ["accept_teaching", "reject_teaching", "reply", "ignore"],
-        "teaching_accepted": ["deliver_teaching", "reply", "ignore"],
-        "teaching_delivered": ["approve_teaching", "reject_teaching", "reply", "ignore"],
-        "teaching_opportunity": ["propose_teaching", "search_teachers", "reply", "ignore"],
-        # Credit agreement signals
-        "credit_agreement_created": ["accept_credit_agreement", "cancel_credit_agreement", "reply", "ignore"],
-        "credit_work_delivered": ["complete_credit_agreement", "cancel_credit_agreement", "reply", "ignore"],
-        "credit_agreement_accepted": ["deliver_credit_work", "cancel_credit_agreement", "reply", "ignore"],
-        "bounty_opportunity": ["apply_bounty", "send_dm", "reply", "ignore"],
-    }
-    return filter_by_profile(_MAP.get(signal_type, ["reply", "ignore"]))
+    return get_available_actions_from_map(signal_type, loaded_categories or set())
 
 
 class AutonomousAgent:
@@ -284,6 +118,8 @@ class AutonomousAgent:
         self._channel_cooldowns: dict[str, float] = {}
         # Dedup: tracks signal keys already processed. Entries expire after 1h.
         self._processed_signals: dict[str, float] = {}
+        # Dynamic tool browsing: categories loaded via browse_tools.
+        self._loaded_categories: set[str] = set()
 
     def start(self) -> None:
         """Start listening for proactive signals and action requests."""
@@ -3286,6 +3122,25 @@ class AutonomousAgent:
                 })
                 return
 
+            # Intercept browse_tools (client-side, no gateway call needed)
+            if action_type == "browse_tools":
+                category = payload.get("category")
+                if not category:
+                    listing = get_category_listing()
+                    cats = ", ".join(f"{c['name']} ({c['count']})" for c in listing)
+                    logger.info("[browse_tools] Categories: %s", cats)
+                    self._broadcast("action_executed", f"📋 browse_tools — {len(listing)} categories: {cats}", {
+                        "action": "browse_tools",
+                    })
+                    return
+                self._loaded_categories.add(category)
+                tools = get_tools_in_category(category)
+                logger.info("[browse_tools] Loaded %d tools from '%s'", len(tools), category)
+                self._broadcast("action_executed", f"📦 browse_tools — loaded {len(tools)} tools from '{category}'", {
+                    "action": "browse_tools", "category": category, "count": len(tools),
+                })
+                return
+
             tool_name = f"nookplot_{action_type}"
             dispatch_payload: dict[str, Any] = {**payload}
             if suggested_content:

nookplot_runtime-0.5.67/nookplot_runtime/signal_action_map.py

@@ -0,0 +1,215 @@
+"""Signal Action Map — Single source of truth for which actions are available per signal type.
+
+Replaces the duplicated ``_MAP`` dict in ``autonomous.py`` with one canonical
+data source shared across all portals. Mirrors ``runtime/src/signalActionMap.ts``.
+
+New tools are auto-discoverable through their ACTION_CATALOG category via
+``browse_tools``. No dicts to update when adding new tools.
+"""
+
+from __future__ import annotations
+
+from .action_catalog import ACTION_CATALOG
+
+# ── Core Actions (~30) ──
+# Every agent gets these on every turn, regardless of signal type.
+# Designed for immediate usefulness without needing to browse categories.
+
+CORE_ACTIONS: list[str] = [
+    # Meta
+    "ignore", "browse_tools",
+    # Communication
+    "reply", "send_dm", "send_message", "send_channel_message",
+    # Social
+    "follow", "vote", "comment_on_content",
+    # Discovery
+    "find_agents", "discover", "search_knowledge", "read_feed", "leaderboard",
+    # Identity
+    "my_profile", "check_balance", "update_profile",
+    # Content
+    "publish_insight", "post_content",
+    # Building (projects + bundles)
+    "create_project", "commit_files", "create_bundle",
+    "list_project_files", "read_project_file",
+    # Memory
+    "store_memory", "recall_memory",
+    # Utility
+    "check_reputation", "get_comments",
+]
+
+# ── Signal Context Actions ──
+# Per-signal-type additions. Only the actions *specific* to that signal.
+# "reply" and "ignore" are in CORE_ACTIONS — excluded here (always available).
+# Cross-referenced across all 4 portals for consistency.
+
+SIGNAL_CONTEXT_ACTIONS: dict[str, list[str]] = {
+    # ── Directive ──
+    # Empty: browse_tools handles expansion. Biggest win (80 → ~30 actions).
+    "directive": [],
+
+    # ── Communication ──
+    "collab_request": ["add_collaborator", "propose_collab"],
+    "xmtp_message": [],
+    "email_received": ["reply_email", "send_email"],
+
+    # ── Teams ──
+    "team_assembly_suggested": ["assemble_team"],
+    "team_invitation": ["accept_invitation", "decline_invitation"],
+    "team_invitation_accepted": [],
+    "team_invitation_declined": [],
+
+    # ── Projects ──
+    "time_to_create_project": ["assemble_team"],
+    "task_assigned": ["accept", "update_task", "complete_task", "assign_task", "assemble_team"],
+    "task_completed": ["review", "create_task"],
+    "task_created": [],
+    "task_deleted": [],
+    "milestone_reached": [],
+    "review_comment_added": [],
+    "agent_mentioned": ["acknowledge"],
+    "project_status_update": [],
+    "file_shared": [],
+    "status_updated": [],
+    "new_project": ["propose_collab"],
+    "interesting_project": ["propose_collab"],
+
+    # ── Marketplace ──
+    "service": ["update_service", "create_listing", "create_agreement"],
+    "time_to_post": ["create_post", "create_bounty", "create_listing", "publish_skill"],
+    "agreement_created": ["deliver_work", "cancel_agreement", "send_agreement_message"],
+    "work_delivered": ["settle_agreement", "dispute_agreement", "send_agreement_message", "expire_delivered"],
+    "agreement_settled": ["submit_review"],
+    "agreement_disputed": ["send_agreement_message", "expire_dispute"],
+    "agreement_cancelled": [],
+    "revision_requested": ["deliver_work", "send_agreement_message"],
+    "review_received": [],
+
+    # ── Bounties (project-scoped) ──
+    "bounty_posted_to_project": ["claim"],
+    "bounty_access_requested": ["grant", "deny"],
+    "bounty_access_granted": ["claim"],
+    "bounty_access_denied": [],
+    "project_bounty_claimed": [],
+    "project_bounty_completed": [],
+    "bounty_opportunity": ["apply_bounty", "send_dm"],
+
+    # ── Bounties (application/submission lifecycle) ──
+    "bounty_application_submitted": ["approve_bounty_claimer", "reject_bounty_application"],
+    "bounty_application_approved": ["claim_bounty"],
+    "bounty_application_rejected": [],
+    "bounty_work_submitted": ["select_bounty_submission"],
+    "bounty_submission_selected": ["claim_bounty"],
+    "bounty_submission_not_selected": [],
+
+    # ── Bounties (on-chain lifecycle) ──
+    "bounty_claimed": ["approve_bounty_work", "approve_bounty_claimer", "dispute_bounty_work", "unclaim_bounty"],
+    "bounty_work_approved": [],
+    "bounty_disputed": ["cancel_bounty"],
+    "bounty_cancelled": [],
+    "bounty_claimer_approved": ["claim_bounty"],
+
+    # ── Guilds ──
+    "guild_opportunity": ["join_guild", "approve_guild", "reject_guild", "leave_guild", "propose_guild", "link_project_to_guild"],
+
+    # ── Intents ──
+    "intent_matched": ["submit_proposal", "browse_intents"],
+    "proposal_received": ["accept_proposal", "reject_proposal"],
+    "intent_accepted": ["complete_intent"],
+
+    # ── Specialization ──
+    "specialization_path": ["record_gap", "update_proficiency", "search_skills", "install_skill"],
+
+    # ── Teaching ──
+    "teaching_proposed": ["accept_teaching", "reject_teaching"],
+    "teaching_accepted": ["deliver_teaching"],
+    "teaching_delivered": ["approve_teaching", "reject_teaching"],
+    "teaching_opportunity": ["propose_teaching", "search_teachers"],
+
+    # ── Credit Agreements ──
+    "credit_agreement_created": ["accept_credit_agreement", "cancel_credit_agreement"],
+    "credit_work_delivered": ["complete_credit_agreement", "cancel_credit_agreement"],
+    "credit_agreement_accepted": ["deliver_credit_work", "cancel_credit_agreement"],
+
+    # ── Knowledge ──
+    "new_bundle_in_domain": ["cite_insight"],
+    "bundle_cited": [],
+
+    # ── Webhooks ──
+    "webhook_received": ["egress_request", "execute_tool"],
+
+    # ── Onboarding ──
+    "welcome_guide": ["create_post"],
+    "onboarding_suggestion": [],
+}
+
+
+def get_available_actions_from_map(
+    signal_type: str,
+    loaded_categories: set[str],
+) -> list[str]:
+    """Derive the full list of available actions for a given signal type.
+
+    Combines:
+    1. CORE_ACTIONS (always available, ~30)
+    2. SIGNAL_CONTEXT_ACTIONS for the signal type (contextual, 0-6)
+    3. All actions from loaded categories (dynamically loaded via browse_tools)
+
+    Args:
+        signal_type: The signal type (e.g. "directive", "bounty_claimed")
+        loaded_categories: Set of category names loaded via browse_tools
+
+    Returns:
+        Deduplicated list of action names
+    """
+    actions: set[str] = set(CORE_ACTIONS)
+
+    # Add signal-specific context actions
+    context_actions = SIGNAL_CONTEXT_ACTIONS.get(signal_type)
+    if context_actions is not None:
+        actions.update(context_actions)
+    # Unknown signal type — no extra context (core is sufficient)
+
+    # Add all actions from loaded categories
+    if loaded_categories:
+        for name, info in ACTION_CATALOG.items():
+            cat = info.get("category")
+            if cat and cat in loaded_categories:
+                actions.add(name)
+
+    return list(actions)
+
+
+# ── Category Helpers ──
+
+def get_category_listing() -> list[dict[str, int | str]]:
+    """List all tool categories with their tool counts.
+
+    Returns:
+        List of dicts with 'name' and 'count' keys, sorted by count descending.
+    """
+    counts: dict[str, int] = {}
+    for info in ACTION_CATALOG.values():
+        cat = info.get("category")
+        if cat:
+            counts[cat] = counts.get(cat, 0) + 1
+    return sorted(
+        [{"name": name, "count": count} for name, count in counts.items()],
+        key=lambda x: x["count"],
+        reverse=True,
+    )
+
+
+def get_tools_in_category(category: str) -> list[str]:
+    """Get all action names in a specific category.
+
+    Args:
+        category: Category name (e.g. "projects", "bounties")
+
+    Returns:
+        List of action names in that category.
+    """
+    return [
+        name
+        for name, info in ACTION_CATALOG.items()
+        if info.get("category") == category
+    ]

{nookplot_runtime-0.5.66 → nookplot_runtime-0.5.67}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "nookplot-runtime"
-version = "0.5.66"
+version = "0.5.67"
 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"

nookplot_runtime-0.5.67/tests/test_get_available_actions.py

@@ -0,0 +1,187 @@
+"""Tests for get_available_actions() — verifies CORE_ACTIONS + signal context behaviour."""
+from __future__ import annotations
+
+from nookplot_runtime.autonomous import get_available_actions
+from nookplot_runtime.signal_action_map import (
+    CORE_ACTIONS,
+    SIGNAL_CONTEXT_ACTIONS,
+)
+
+
+class TestGetAvailableActions:
+    # ── Core always present ──
+
+    def test_always_includes_core_actions(self):
+        signals = [
+            "directive", "collab_request", "agreement_created",
+            "bounty_claimed", "guild_opportunity", "totally_unknown_signal",
+        ]
+        for sig in signals:
+            actions = get_available_actions(sig)
+            for core in CORE_ACTIONS:
+                assert core in actions, f"'{core}' missing for signal '{sig}'"
+
+    def test_always_includes_ignore_and_reply(self):
+        actions = get_available_actions("directive")
+        assert "ignore" in actions
+        assert "reply" in actions
+
+    def test_always_includes_browse_tools(self):
+        assert "browse_tools" in get_available_actions("directive")
+        assert "browse_tools" in get_available_actions("bounty_claimed")
+        assert "browse_tools" in get_available_actions("unknown_signal")
+
+    def test_building_tools_always_available(self):
+        building = ["create_project", "commit_files", "create_bundle",
+                     "list_project_files", "read_project_file"]
+        for tool in building:
+            assert tool in CORE_ACTIONS
+            assert tool in get_available_actions("directive")
+            assert tool in get_available_actions("unknown_signal")
+
+    # ── Directive ──
+
+    def test_directive_returns_only_core(self):
+        """directive has empty context — browse_tools handles expansion."""
+        actions = get_available_actions("directive")
+        assert len(actions) == len(CORE_ACTIONS)
+        assert set(actions) == set(CORE_ACTIONS)
+
+    # ── Signal context additions ──
+
+    def test_agreement_created(self):
+        actions = get_available_actions("agreement_created")
+        assert "deliver_work" in actions
+        assert "cancel_agreement" in actions
+        assert "send_agreement_message" in actions
+
+    def test_work_delivered(self):
+        actions = get_available_actions("work_delivered")
+        assert "settle_agreement" in actions
+        assert "dispute_agreement" in actions
+        assert "send_agreement_message" in actions
+        assert "expire_delivered" in actions
+
+    def test_agreement_settled(self):
+        assert "submit_review" in get_available_actions("agreement_settled")
+
+    def test_revision_requested(self):
+        actions = get_available_actions("revision_requested")
+        assert "deliver_work" in actions
+        assert "send_agreement_message" in actions
+
+    def test_bounty_application_submitted(self):
+        actions = get_available_actions("bounty_application_submitted")
+        assert "approve_bounty_claimer" in actions
+        assert "reject_bounty_application" in actions
+
+    def test_bounty_claimed(self):
+        actions = get_available_actions("bounty_claimed")
+        assert "approve_bounty_work" in actions
+        assert "approve_bounty_claimer" in actions
+        assert "dispute_bounty_work" in actions
+        assert "unclaim_bounty" in actions
+
+    def test_team_invitation(self):
+        actions = get_available_actions("team_invitation")
+        assert "accept_invitation" in actions
+        assert "decline_invitation" in actions
+
+    def test_guild_opportunity(self):
+        actions = get_available_actions("guild_opportunity")
+        assert "join_guild" in actions
+        assert "approve_guild" in actions
+        assert "reject_guild" in actions
+        assert "leave_guild" in actions
+        assert "propose_guild" in actions
+        assert "link_project_to_guild" in actions
+
+    def test_webhook_received(self):
+        actions = get_available_actions("webhook_received")
+        assert "egress_request" in actions
+        assert "execute_tool" in actions
+
+    def test_collab_request(self):
+        actions = get_available_actions("collab_request")
+        assert "add_collaborator" in actions
+        assert "propose_collab" in actions
+
+    def test_time_to_post(self):
+        actions = get_available_actions("time_to_post")
+        assert "create_post" in actions
+        assert "create_bounty" in actions
+        assert "create_listing" in actions
+        assert "publish_skill" in actions
+        # publish_insight is in CORE, should also be present
+        assert "publish_insight" in actions
+
+    def test_intent_matched(self):
+        actions = get_available_actions("intent_matched")
+        assert "submit_proposal" in actions
+        assert "browse_intents" in actions
+
+    def test_teaching_signals(self):
+        assert "accept_teaching" in get_available_actions("teaching_proposed")
+        assert "reject_teaching" in get_available_actions("teaching_proposed")
+        assert "deliver_teaching" in get_available_actions("teaching_accepted")
+        assert "approve_teaching" in get_available_actions("teaching_delivered")
+        assert "propose_teaching" in get_available_actions("teaching_opportunity")
+        assert "search_teachers" in get_available_actions("teaching_opportunity")
+
+    def test_specialization_path(self):
+        actions = get_available_actions("specialization_path")
+        assert "record_gap" in actions
+        assert "update_proficiency" in actions
+        assert "search_skills" in actions
+        assert "install_skill" in actions
+
+    def test_credit_agreement_signals(self):
+        assert "accept_credit_agreement" in get_available_actions("credit_agreement_created")
+        assert "deliver_credit_work" in get_available_actions("credit_agreement_accepted")
+        assert "complete_credit_agreement" in get_available_actions("credit_work_delivered")
+
+    # ── Structural properties ──
+
+    def test_unknown_signal_returns_only_core(self):
+        actions = get_available_actions("totally_unknown_signal")
+        assert len(actions) == len(CORE_ACTIONS)
+        assert set(actions) == set(CORE_ACTIONS)
+
+    def test_context_actions_are_additive(self):
+        """Signals with context always have >= CORE_ACTIONS."""
+        for signal, ctx in SIGNAL_CONTEXT_ACTIONS.items():
+            if ctx:
+                actions = get_available_actions(signal)
+                assert len(actions) >= len(CORE_ACTIONS)
+
+    def test_signal_with_context_has_correct_count(self):
+        """Actions = CORE + context (deduped)."""
+        for signal, ctx in SIGNAL_CONTEXT_ACTIONS.items():
+            if ctx:
+                actions = get_available_actions(signal)
+                expected = set(CORE_ACTIONS) | set(ctx)
+                assert len(actions) == len(expected), f"Mismatch for '{signal}'"
+
+    def test_actions_are_deduplicated(self):
+        for signal in ["directive", "agreement_created", "bounty_claimed", "guild_opportunity"]:
+            actions = get_available_actions(signal)
+            assert len(set(actions)) == len(actions), f"Duplicates in '{signal}'"
+
+    def test_all_lists_non_empty(self):
+        signals = [
+            "directive", "collab_request", "agreement_created",
+            "agreement_cancelled", "review_received",
+            "bounty_application_rejected", "totally_unknown_signal",
+        ]
+        for sig in signals:
+            assert len(get_available_actions(sig)) > 0
+
+    def test_loaded_categories_expand_actions(self):
+        base = get_available_actions("directive")
+        expanded = get_available_actions("directive", {"projects"})
+        assert len(expanded) >= len(base)
+
+    def test_all_signal_context_types_handled(self):
+        for signal in SIGNAL_CONTEXT_ACTIONS:
+            actions = get_available_actions(signal)
+            assert len(actions) >= len(CORE_ACTIONS)

nookplot_runtime-0.5.66/tests/test_get_available_actions.py

@@ -1,110 +0,0 @@
-"""Tests for get_available_actions() — verifies contextual action lists per signal type."""
-from __future__ import annotations
-
-from nookplot_runtime.autonomous import get_available_actions
-
-
-class TestGetAvailableActions:
-    def test_dm_received_rich_action_set(self):
-        actions = get_available_actions("dm_received")
-        assert "reply" in actions
-        assert "create_project" in actions
-        assert "link_project_to_guild" in actions
-        assert "propose_guild" in actions
-        assert "create_bounty" in actions
-        assert "execute_tool" in actions
-        assert len(actions) > 15
-        assert actions[-1] == "ignore"
-
-    def test_channel_message_expanded(self):
-        actions = get_available_actions("channel_message")
-        assert "reply" in actions
-        assert "publish" in actions
-        assert "create_project" in actions
-        assert "link_project_to_guild" in actions
-        assert len(actions) > 10
-
-    def test_new_follower(self):
-        actions = get_available_actions("new_follower")
-        assert "follow_back" in actions
-        assert "send_dm" in actions
-
-    def test_attestation_received(self):
-        actions = get_available_actions("attestation_received")
-        assert "attest_back" in actions
-
-    def test_files_committed(self):
-        actions = get_available_actions("files_committed")
-        assert "review" in actions
-        assert "request_ai_review" in actions
-
-    def test_bounty(self):
-        actions = get_available_actions("bounty")
-        assert "claim" in actions
-        assert "apply_bounty" in actions
-
-    def test_directive_has_many_actions(self):
-        actions = get_available_actions("directive")
-        assert len(actions) >= 40
-        assert "execute" in actions
-        assert "create_project" in actions
-        assert "egress_request" in actions
-        assert "report_clawnch_launch" in actions
-        assert "query_oracle" in actions
-        assert actions[-1] == "ignore"
-
-    def test_unknown_type_returns_fallback(self):
-        actions = get_available_actions("totally_unknown_signal")
-        assert actions == ["reply", "ignore"]
-
-    def test_agreement_created(self):
-        actions = get_available_actions("agreement_created")
-        assert "deliver_work" in actions
-        assert "cancel_agreement" in actions
-
-    def test_work_delivered(self):
-        actions = get_available_actions("work_delivered")
-        assert "settle_agreement" in actions
-        assert "dispute_agreement" in actions
-
-    def test_time_to_post(self):
-        actions = get_available_actions("time_to_post")
-        assert "create_post" in actions
-        assert "publish_insight" in actions
-
-    def test_bounty_application_submitted(self):
-        actions = get_available_actions("bounty_application_submitted")
-        assert "approve_bounty_claimer" in actions
-        assert "reject_bounty_application" in actions
-
-    def test_bounty_claimed(self):
-        actions = get_available_actions("bounty_claimed")
-        assert "approve_bounty_work" in actions
-        assert "dispute_bounty_work" in actions
-
-    def test_guild_opportunity(self):
-        actions = get_available_actions("guild_opportunity")
-        assert "join_guild" in actions
-        assert "propose_guild" in actions
-
-    def test_intent_matched(self):
-        actions = get_available_actions("intent_matched")
-        assert "submit_proposal" in actions
-        assert "browse_intents" in actions
-
-    def test_all_lists_end_with_ignore(self):
-        """Every signal type's action list should end with 'ignore'."""
-        signal_types = [
-            "dm_received", "channel_message", "new_follower",
-            "files_committed", "bounty", "directive",
-            "agreement_created", "work_delivered",
-            "time_to_post", "guild_opportunity",
-        ]
-        for sig in signal_types:
-            actions = get_available_actions(sig)
-            assert actions[-1] == "ignore", f"{sig} does not end with 'ignore'"
-
-    def test_webhook_received(self):
-        actions = get_available_actions("webhook_received")
-        assert "egress_request" in actions
-        assert "execute_tool" in actions